Изменение колонок
YDB поддерживает возможность добавлять колонки в строковые и колоночные таблицы, удалять неключевые колонки из таблиц, а также изменять свойства существующих колонок.
ADD COLUMN
Строит новую колонку с указанными именем, типом и опциями для указанной таблицы.
ALTER TABLE table_name ADD COLUMN column_name column_data_type [FAMILY <family_name>] [NULL | NOT NULL] [DEFAULT <default_value>] [COMPRESSION([algorithm=<algorithm_name>[, level=<value>]])];
Параметры запроса
table_name
Путь таблицы, для которой требуется добавить новую колонку.
column_name
Имя колонки, которая будет добавлена в указанную таблицу. При выборе имени для колонки учитывайте общие правила именования колонок.
column_data_type
Тип данных колонки. Полный список типов данных, которые поддерживает YDB доступен в разделе Типы данных YQL.
FAMILY <family_name> (настройка колонки)
Указание принадлежности данной колонки к указанной группе колонок. Подробнее в разделе Группы колонок.
DEFAULT <default_value>
Важно
Опция DEFAULT поддерживается:
- Только для строковых таблиц. Поддержка функциональности для колоночных таблиц находится в разработке.
- Только с литеральными значениями. Поддержка функциональности для вычислимых выражений находится в разработке.
Позволяет задать значение по умолчанию для колонки. Если при вставке строки значение для данной колонки не указано, будет использовано указанное значение по умолчанию. Значение по умолчанию должно соответствовать типу данных колонки.
Конструкция DEFAULT false NOT NULL недопустима по причине неоднозначности интерпретации. В таком случае следует использовать перечисление через запятые или изменить порядок опций.
NULL
Данная колонка может содержать значения NULL (по умолчанию).
NOT NULL
Данная колонка не принимает значения NULL.
COMPRESSION([algorithm=<algorithm_name>[, level=]])
Важно
Поддерживается только для колоночных таблиц.
Для колонок можно задать следующие параметры сжатия:
-
algorithm— алгоритм сжатия данных. Допустимые значения:off(отключение сжатия),lz4,zstd. -
level— уровень сжатия, поддерживается только для алгоритмаzstd(допустимы значения от 0 до 22).
Если COMPRESSION() указан без параметров, для колонки используется сжатие по умолчанию. Сейчас это lz4; в будущих версиях появится возможность настраивать сжатие по умолчанию на уровне кластера или таблицы.
Пример
Приведённый ниже код добавит к таблице episodes колонку views с типом данных Uint64.
ALTER TABLE episodes ADD COLUMN views Uint64;
Приведённый ниже код добавит к таблице episodes колонку rate с типом данных Double и значением по умолчанию 5.0.
ALTER TABLE episodes ADD COLUMN rate Double NOT NULL DEFAULT 5.0;
ALTER TABLE episodes ADD COLUMN rate Double (DEFAULT 5.0, NOT NULL); -- альтернативный синтаксис
ALTER COLUMN
Изменяет свойства существующей колонки в указанной таблице. Изменение свойства происходит без пересоздания колонки. Некоторые свойства применяются только к свежим записанным данным или в процессе компакшена (детали можно найти в описании конкретного свойства)
ALTER TABLE table_name ALTER COLUMN column_name {SET | DROP} [FAMILY <family_name>] [NULL | NOT NULL] [DEFAULT <default_value>] [COMPRESSION([algorithm=<algorithm_name>[, level=<value>]])];
Параметры запроса
table_name
Путь к таблице, в которой требуется изменить колонку.
column_name
Имя колонки, которая будет изменена в указанной таблице.
SET
Установить параметр колонки
DROP
Удалить параметр колонки. На текущий момент поддерживается только удаление NOT NULL.
FAMILY <family_name> (настройка колонки)
Указание принадлежности данной колонки к указанной группе колонок. Подробнее в разделе Группы колонок.
DEFAULT <default_value>
Важно
Опция DEFAULT поддерживается:
- Только для строковых таблиц. Поддержка функциональности для колоночных таблиц находится в разработке.
- Только с литеральными значениями. Поддержка функциональности для вычислимых выражений находится в разработке.
Позволяет задать значение по умолчанию для колонки. Если при вставке строки значение для данной колонки не указано, будет использовано указанное значение по умолчанию. Значение по умолчанию должно соответствовать типу данных колонки.
Конструкция DEFAULT false NOT NULL недопустима по причине неоднозначности интерпретации. В таком случае следует использовать перечисление через запятые или изменить порядок опций.
NULL
Данная колонка может содержать значения NULL (по умолчанию).
NOT NULL
Данная колонка не принимает значения NULL.
COMPRESSION([algorithm=<algorithm_name>[, level=]])
Важно
Поддерживается только для колоночных таблиц.
Для колонок можно задать следующие параметры сжатия:
-
algorithm— алгоритм сжатия данных. Допустимые значения:off(отключение сжатия),lz4,zstd. -
level— уровень сжатия, поддерживается только для алгоритмаzstd(допустимы значения от 0 до 22).
Если COMPRESSION() указан без параметров, для колонки используется сжатие по умолчанию. Сейчас это lz4; в будущих версиях появится возможность настраивать сжатие по умолчанию на уровне кластера или таблицы.
Примеры
Приведённый ниже код запретит пустые значения в колонке title из таблицы episodes.
ALTER TABLE episodes ALTER COLUMN title SET NOT NULL;
Важно
Поддерживается только для колоночных таблиц.
Сброс настроек сжатия колонки
ALTER TABLE compressed_table ALTER COLUMN info SET COMPRESSION();
После выполнения запроса для колонки снова действует алгоритм сжатия по умолчанию (см. описание опции COMPRESSION выше).
DROP COLUMN
Удаляет колонку из таблицы с указанным именем.
ALTER TABLE table_name DROP COLUMN column_name;
Параметры запроса
table_name
Путь к таблице, в которой требуется удалить колонку.
column_name
Имя колонки, которая будет удалена из указанной таблицы.
Пример
Приведённый ниже код удалит колонку views из таблицы episodes.
ALTER TABLE episodes DROP COLUMN views;