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