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


Команда таблицы create-merge

Создает новую таблицу или расширяет существующую таблицу.

Команда должна выполняться в контексте определенной базы данных.

Разрешения

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

Синтаксис

.create-mergetable tableName columnName(: columnType [, ...]) [ propertyName = propertyValue [, (with...]])

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

Параметры

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

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

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

Возвраты

Если таблица не существует, функции выполняются точно так же, как .create table команда.

Если таблица T существует, и вы отправляете .create-merge table T (<columns specification>) команду, а затем:

  • Любой столбец в <спецификации> столбцов, которые ранее не существовали в T, будут добавлены в конец схемы T.
  • Любой столбец в T, который не указан в <спецификации> столбцов, не будет удален из T.
  • Любой столбец в спецификации> столбцов, который существует в <T, но с другим типом данных приведет к сбою команды.