Перейти к содержанию

ALTER TABLE

DDL-команда ALTER TABLE используется для изменения схемы таблицы.

Синтаксис

ALTER TABLE table RENAME TO table ADD COLUMN IF NOT EXISTS column type NOT NULL , WAIT APPLIED GLOBALLY LOCALLY OPTION ( TIMEOUT = double )

Тип

Диаграмма

Параметры

  • TABLE — имя таблицы. Соответствует правилам имен для всех объектов в кластере

  • RENAME TO — позволяет задать таблице новое имя

  • ADD / ADD COLUMN — позволяет добавить одну или несколько колонок с указанием их типа и ограничения на то, может ли колонка принимать значение NULL. Указание IF NOT EXISTS позволяет избежать ошибки в случае, если хотя бы одна из добавляемых колонок уже есть в таблице

  • WAIT APPLIED — при использовании этого параметра контроль пользователю будет возвращен только после того как данная операция будет применена либо во всем кластере (GLOBALLY), либо в рамках текущего инстанса (LOCALLY)

  • TIMEOUT — интервал времени, за который Picodata пытается изменить таблицу в кластере. Если времени не хватило и вернулась ошибка, то или таблица не успела измениться, или изменилась, но нам не хватило времени получить об этом подтверждение. Чтобы проверить статус таблицы, можно повторить еще раз команду ее изменения. Если она изменена, то в результате вернется нуль строк. Если же таблица не была изменена, то вернется одна строка.

Примеры

Как и при создании таблицы, при добавлении колонки можно указать требование содержать значение (NOT NULL), однако это поддерживается только для пустых таблиц (т.к. в таблице с данными добавление колонки автоматически создает поля со значением NULL):

Добавление колонки к таблице с данными
ALTER TABLE warehouse
ADD COLUMN "quantity" INT NULL;
Добавление колонки к пустой таблице
ALTER TABLE warehouse
ADD COLUMN "quantity" INT NOT NULL;
Переименование таблицы
ALTER TABLE warehouse
RENAME TO sklad;