CREATE TABLE¶

DDL-команда CREATE TABLE используется для создания новой шардированной или глобальной таблицы.

Синтаксис¶

Тип¶

Диаграмма

Параметры¶

TABLE — имя таблицы. Соответствует правилам имен для всех объектов в кластере
IF NOT EXISTS — позволяет избежать ошибки в случае, если такая таблица в кластере уже есть
PRIMARY KEY — первичный ключ. Обеспечивает уникальность и сортировку данных только в рамках одного экземпляра кластера. Глобальную уникальность записи он не дает
DISTRIBUTED GLOBALLY — глобальное распределение таблицы. В результате данные в таблице идентичны на всех экземплярах кластера и синхронизируются через Raft-журнал. Поддерживается только для движка хранения данных memtx
DISTRIBUTED BY — шардирование таблицы по набору колонок. В результате каждый экземпляр содержит только часть данных в таблице
IN TIER — имя тира, в котором будет создана шардированная таблица. Если параметр не задан, будет использовано имя тира по умолчанию default.
MEMTX — движок хранения данных в памяти
VINYL — дисковый движок хранения данных, использующий LSM-деревья (Log Structured Merge Tree)
WAIT APPLIED — при использовании этого параметра контроль пользователю будет возвращен только после того как данная операция будет применена либо во всем кластере (GLOBALLY), либо в рамках текущего инстанса (LOCALLY)
TIMEOUT — интервал времени, за который Picodata пытается создать таблицу в кластере. Если времени не хватило и вернулась ошибка, то или таблица не успела создаться, или создалась, но нам не хватило времени получить об этом подтверждение. Чтобы проверить статус таблицы, можно повторить еще раз команду ее создания. Если таблица создана, то в результате вернется нуль строк. Если же таблица не была создана, то вернется одна строка.

Примеры¶

Минимально возможная команда

CREATE TABLE warehouse (
    id INTEGER PRIMARY KEY);

Примечание

Если параметр DISTRIBUTED не указан, то по умолчанию таблица будет шардирована по колонкам первичного ключа.

Создание таблицы с использованием движка хранения memtx

CREATE TABLE warehouse (
    id INTEGER NOT NULL,
    item TEXT NOT NULL,
    type TEXT NOT NULL,
    PRIMARY KEY (id))
USING memtx DISTRIBUTED BY (id)
OPTION (TIMEOUT = 3.0);

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

CREATE TABLE warehouse (
    id INTEGER PRIMARY KEY,
    item TEXT NOT NULL,
    type TEXT NOT NULL)
USING memtx DISTRIBUTED BY (id)
OPTION (TIMEOUT = 3.0);

Создание таблицы с шардированием в тире default

CREATE TABLE warehouse (
    id INTEGER PRIMARY KEY,
    item TEXT NOT NULL,
    type TEXT NOT NULL)
USING memtx DISTRIBUTED BY (id)
IN TIER "default"
OPTION (TIMEOUT = 3.0);