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


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

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

Разрешения

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

Синтаксис

.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