Команда на основе таблицы .create

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

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

Примечание.

Все свойства исходной таблицы копируются в новую таблицу со следующими исключениями:

Обновление политики
Авторизованные субъекты: при использовании .create table based-on команды текущий субъект добавляется к администраторам таблицы.

Разрешения

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

.createtable tableName otherTable [ifnotexists] [with (propertyName = based-on propertyValue [, ...]])

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

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

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

Эта команда возвращает схему новой таблицы в формате JSON, аналогичную выполнению следующей команды:

.show table MyLogs schema as json

Примечание.

Если таблица уже существует:
- Если ifnotexists задан флаг, команда игнорируется (не применяется никаких изменений).
- Если ifnotexists флаг НЕ указан, возвращается ошибка.

.create table MyLogs_Temp based-on MyLogs with (folder="TempTables")