Команда таблицы alter-merge
Область применения: ✅Microsoft Fabric✅Azure Data Explorer
Команда .alter-merge table делает следующее:
- Защита данных в существующих столбцах
- Добавляет новые столбцы
docstringи папку в существующую таблицу - Должен выполняться в контексте определенной базы данных, которая определяет имя таблицы.
Разрешения
Для выполнения этой команды необходимо иметь по крайней мере разрешения администратора таблицы.
Синтаксис
.alter-mergetable tableName columnName(: columnType [, ...]) [ propertyName = propertyValue [, (with...]])
Дополнительные сведения о соглашениях синтаксиса.
Параметры
| Имя (название) | Type | Обязательно | Описание |
|---|---|---|---|
| tableName | string |
✔️ | Имя таблицы для изменения. |
| columnName, columnType | string |
✔️ | Имя существующего или нового столбца, сопоставленного с типом данных в этом столбце. Список этих сопоставлений определяет схему выходного столбца. |
| propertyName, propertyValue | string |
Разделенный запятыми список пар свойств "ключ-значение". См . поддерживаемые свойства. |
Примечание.
При попытке изменить тип столбца команда завершится ошибкой. Вместо этого используйте .alter column.
Совет
Используйте .show table [tableName] cslschema для получения существующей схемы столбца перед его изменением.
Поддерживаемые свойства
| Имя. | Тип | Описание |
|---|---|---|
docstring |
string |
Бесплатный текст, описывающий добавляемую сущность. Эта строка представлена в различных параметрах пользовательского интерфейса рядом с именами сущностей. |
folder |
string |
Имя папки, добавляемой в таблицу. |
Как команда влияет на данные
- Существующие данные не будут изменены или удалены
- Новые столбцы будут добавлены в конец схемы
- Предполагается, что данные в новых столбцах являются null
Примеры
.alter-merge table MyTable (ColumnX:string, ColumnY:int)
.alter-merge table MyTable (ColumnX:string, ColumnY:int) with (docstring = "Some documentation", folder = "Folder1")
Связанный контент
.alter Используйте команду таблицы, если вы хотите дополнительно переопределить параметры таблицы. Дополнительные сведения см. в статье .alter table.