Команда alter table

Область применения: ✅Microsoft Fabric✅Azure Data Explorer

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

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

Предупреждение

.alter Неправильное использование команды может привести к потере данных.

Разрешения

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

Синтаксис

.altertable tableName columnName(: columnType [, ...]) [ propertyName = propertyValue [, (with...]])

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

Параметры

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

Предупреждение

Существующие столбцы, которые не указаны в команде, будут удалены. Это может привести к неожиданной потере данных.

Совет

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

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

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

Как команда влияет на данные

• Существующие данные в столбцах, перечисленных в команде, не будут изменены
• Существующие данные в столбцах, не перечисленных в команде, будут удалены
• Новые столбцы будут добавлены в конец схемы
• Предполагается, что данные в новых столбцах являются null
• Таблица будет иметь те же столбцы в том же порядке, что и указано

Примечание.

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

Предупреждение

• Прием данных, который игнорирует порядок столбцов и выполняется параллельно с .alter table рисками приема данных в неправильные столбцы. Чтобы предотвратить это, убедитесь, что прием использует объект сопоставления или остановить прием во время выполнения .alter table команды.
• Прием данных может изменить схему столбцов таблицы. Будьте осторожны, чтобы не случайно удалить нужные столбцы, добавленные во время приема.

Примеры

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

Связанный контент

• Используйте .alter-merge , если вы хотите сохранить параметры таблицы и переопределить или развернуть только определенные столбцы. Дополнительные сведения см. в таблице alter-merge.
• Чтобы изменить политику хранения таблиц, см. статью .alter table policy retention.
• Сведения об изменении политики кэширования таблицы см. в разделе .alter table policy кэширование.
• Чтобы изменить политику обновления таблицы, см . статью об обновлении политики изменения таблицы .alter.
• Чтобы изменить политику слияния таблиц, см . статью "Alter table policy merge".