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

Статья
11/23/2024

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

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

Разрешения

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

Синтаксис

.create-mergetables tableName1 (columnName:columnType [, ...]) [, tableName2 (columnName:columnType, [ ...]) ... [with (propertyName = propertyValue [, ...]])

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

Параметры

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

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

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

Возвраты

Указанные таблицы, которые не существуют, будут созданы.
Указанные таблицы, которые уже существуют, будут расширены.
- Несуществующие столбцы добавляются в конце схемы существующей таблицы.
- Существующие столбцы, которые не указаны в команде, не будут удалены из схемы существующей таблицы.
- Существующие столбцы, указанные с типом данных в команде, отличной от одной из схем существующей таблицы, приводят к сбою. Таблицы не создаются.

Пример

.create-merge tables 
  MyLogs (Level:string, Timestamp:datetime, UserId:string, TraceId:string, Message:string, ProcessId:int32),
  MyUsers (UserId:string, Name:string)

Выходные данные

tableName	имя_базы_данных	Папка	DocString
MyLogs	TopComparison
MyUsers	TopComparison

Поделиться через