Команда .create table
Область применения: ✅Microsoft Fabric✅Azure Data Explorer
Создает пустую таблицу.
Команда должна выполняться в контексте определенной базы данных.
Разрешения
Для выполнения этой команды необходимо иметь по крайней мере разрешения пользователя базы данных.
Синтаксис
.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 команду для повышения производительности и снижения нагрузки данных.