Команда .create table

Создает пустую таблицу.

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

Разрешения

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

Синтаксис

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

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

Параметры

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

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

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

Примечание.

Если таблица с тем же именем (с учетом регистра) уже существует в контексте базы данных, команда возвращает успешное выполнение без изменения существующей таблицы даже в следующих сценариях:

• Указанная схема не соответствует схеме существующей таблицы
• docstring Параметры folder указываются со значениями, отличными от значений, заданных в таблице.

Пример

.create table MyLogs ( Level:string, Timestamp:datetime, UserId:string, TraceId:string, Message:string, ProcessId:int32 ) 

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

Возвращает схему таблицы в формате JSON, так же, как:

.show table MyLogs schema as json

Примечание.

Чтобы создать несколько таблиц, используйте .create tables команду для повышения производительности и снижения нагрузки на кластер.