CREATE TABLE

Содержание раздела
  1. Синтаксис
    1. Ключевое слово DATASOURCE_TYPE
    2. Ключевое слово LOGICAL_ONLY
  2. Ограничения
    1. Ограничения выполнения
    2. Ограничения имен
    3. Ограничения столбцов
  3. Примеры
    1. Создание таблицы с размещением данных во всех СУБД хранилища
    2. Создание таблицы с составным первичным ключом
    3. Создание таблицы с размещением данных в ADP и ADG
    4. Создание таблицы только на логическом уровне

Запрос создает логическую таблицу в логической базе данных.

Запрос попадает в очередь операций и обрабатывается в порядке его поступления в очередь. В ответе возвращается:

  • пустой объект ResultSet при успешном выполнении запроса;
  • исключение при неуспешном выполнении запроса.

При успешном выполнении запроса система создает логическую таблицу, а также подготавливает хранилище к размещению данных таблицы — создает физические таблицы, связанные с логической таблицей и предназначенные для хранения ее данных.

По умолчанию система создает физические таблицы во всех СУБД хранилища инсталляции. Это означает, что при добавлении данных в логическую таблицу система добавляет их во все СУБД. Чтобы настроить размещения данных логической таблицы только в некоторых СУБД хранилища, следует указать в запросе CREATE TABLE ключевое слово DATASOURCE_TYPE со списком нужных СУБД.

Ошибка выполнения корректного запроса блокирует исполнение последующих запросов в этой логической базе данных. В случае блокировки нужно устранить причины сбоя и повторить сбойную операцию. Если повторение операции невозможно, удалите сбойную операцию запросом ERASE_CHANGE_OPERATION и вручную устраните несоответствия на физическом уровне (если такие есть).

Изменение логической таблицы недоступно. Чтобы заменить таблицу, удалите ее и создайте новую.

Каждое создание таблицы записывается в журнал. Журнал можно посмотреть с помощью запроса GET_CHANGES.

Синтаксис

CREATE TABLE [db_name.]table_name (
  column_name_1 datatype_1 [ NULL | NOT NULL ],
  column_name_2 datatype_2 [ NULL | NOT NULL ],
  column_name_3 datatype_3 [ NULL | NOT NULL ],
  PRIMARY KEY (column_list_1)
) DISTRIBUTED BY (column_list_2)
[DATASOURCE_TYPE (datasource_aliases)]
[LOGICAL_ONLY]

Параметры:

db_name

Имя логической базы данных, в которой создается логическая таблица. Опционально, если выбрана логическая БД, используемая по умолчанию.

table_name

Имя создаваемой логической таблицы, уникальное среди логических сущностей логической БД.

column_name_N

Имя столбца таблицы.

datatype_N

Тип данных столбца column_name_N. Возможные значения см. в разделе Логические типы данных.

column_list_1

Список столбцов, входящих в первичный ключ таблицы.

column_list_2

Список столбцов, входящих в ключ шардирования таблицы. Столбцы должны быть из числа столбцов column_list_1.

datasource_aliases

Список псевдонимов СУБД хранилища, в которых нужно разместить данные таблицы. Элементы списка перечисляются через запятую. Возможные значения: adb, adqm, adg. Значения можно указывать без кавычек (например, adb) или двойных кавычках (например, "adb").

Ключевое слово DATASOURCE_TYPE

Ключевое слово DATASOURCE_TYPE позволяет указать СУБД хранилища, в которых необходимо размещать данные логической таблицы.

Если ключевое слово не указано, данные таблицы размещаются во всех доступных СУБД хранилища.

Ключевое слово LOGICAL_ONLY

Ключевое слово LOGICAL_ONLY позволяет создать логическую таблицу только на логическом уровне (в логической схеме данных), без пересоздания связанных физических таблиц в хранилище данных.

Если ключевое слово не указано, создается как логическая, так и связанные с ней физические таблицы.

Ограничения

Ограничения выполнения

  • Выполнение запроса недоступно при наличии любого из факторов:
    • горячей дельты,
    • запрета на изменение сущностей (см. раздел DENY_CHANGES).
  • Запрос не может быть выполнен в сервисной базе данных INFORMATION_SCHEMA.

Ограничения имен

  • Имена таблицы и ее столбцов должны начинаться с латинской буквы. После первого символа могут следовать латинские буквы, цифры и символы подчеркивания в любом порядке.
  • Имена таблицы и ее столбцов не могут быть из числа зарезервированных слов.
  • Имена столбцов не могут быть равны или начинаться со следующих служебных слов: sys_op, sys_from, sys_to, sys_close_date, bucket_id, sign.
  • Имена столбцов должны быть уникальны в рамках логической таблицы.

Ограничения столбцов

  • Первичный ключ должен включать все столбцы ключа шардирования.

Примеры

Создание таблицы с размещением данных во всех СУБД хранилища

CREATE TABLE marketing.sales (
  id INT NOT NULL,
  transaction_date TIMESTAMP NOT NULL,
  product_code VARCHAR(256) NOT NULL,
  product_units INT NOT NULL,
  store_id INT NOT NULL,
  description VARCHAR(256),
  PRIMARY KEY (id)
)
DISTRIBUTED BY (id)

Создание таблицы с составным первичным ключом

CREATE TABLE marketing.stores (
  id INT NOT NULL,
  category VARCHAR(256) NOT NULL,
  region VARCHAR(256) NOT NULL,
  address VARCHAR(256) NOT NULL,
  description VARCHAR(256),
  PRIMARY KEY (id, region)
)
DISTRIBUTED BY (id)

Создание таблицы с размещением данных в ADP и ADG

CREATE TABLE marketing.clients (
  id INT NOT NULL,
  first_name VARCHAR(256) NOT NULL,
  last_name VARCHAR(256) NOT NULL,
  patronymic_name VARCHAR(256),
  birth_date DATE,
  PRIMARY KEY (id)
) DISTRIBUTED BY (id)
DATASOURCE_TYPE (adp,adg)

Создание таблицы только на логическом уровне

CREATE TABLE marketing.sales1 (
  id INT NOT NULL,
  transaction_date TIMESTAMP NOT NULL,
  product_code VARCHAR(256) NOT NULL,
  product_units INT NOT NULL,
  store_id INT NOT NULL,
  description VARCHAR(256),
  PRIMARY KEY (id)
)
DISTRIBUTED BY (id)
LOGICAL_ONLY