Команда .alter-merge table

Команда .alter-merge table делает следующее:

• Защита данных в существующих столбцах
• Добавляет новые столбцы, docstringи папку в существующую таблицу.
• Должен выполняться в контексте конкретной базы данных, которая определяет имя таблицы.

Разрешения

Для выполнения этой команды необходимо иметь по крайней мере разрешения на Администратор таблиц.

Синтаксис

.alter-mergetableTablename(columnName:columnType [, ...]) [with(propertyName=propertyValue [, ...])]

Дополнительные сведения о соглашениях о синтаксисе.

Параметры

Имя	Тип	Обязательно	Описание
tableName	string	✔️	Имя изменяемой таблицы.
columnName, columnType	string	✔️	Имя существующего или нового столбца, сопоставленного с типом данных в этом столбце. Список этих сопоставлений определяет схему выходного столбца.
propertyName, propertyValue	string		Разделенный запятыми список пар свойств "ключ-значение". См. раздел Поддерживаемые свойства.

Примечание

При попытке изменить тип столбца команда завершится ошибкой. Взамен рекомендуется использовать .alter column.

Совет

Используйте .show table [tableName] cslschema , чтобы получить существующую схему столбца перед ее изменением.

Поддерживаемые свойства

Имя	Тип	Описание
docstring	string	Свободный текст, описывающий добавляемую сущность. Эта строка представлена в различных параметрах пользовательского интерфейса рядом с именами сущностей.
folder	string	Имя папки, добавляемой в таблицу.

Влияние команды на данные

• Существующие данные не будут изменены или удалены
• Новые столбцы будут добавлены в конец схемы.
• Данные в новых столбцах считаются пустыми.

Примеры

.alter-merge table MyTable (ColumnX:string, ColumnY:int) 
.alter-merge table MyTable (ColumnX:string, ColumnY:int) with (docstring = "Some documentation", folder = "Folder1")

См. также

.alter Используйте команду table, чтобы дополнительно переопределить параметры таблицы. Дополнительные сведения см. в разделе .alter table.