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

Команда сопоставления приема .create

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

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

Если сопоставление с тем же именем в заданной области уже существует, .create завершается ошибкой. Вместо этого используйте .create-or-alter.

Разрешения

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

Синтаксис

.createtable TableName ingestion MappingKind mapping MappingName MappingFormattedAsJson

.createdatabase DatabaseName MappingKind mapping MappingName ingestion MappingFormattedAsJson

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

Параметры

Имя (название) Type Обязательно Описание
TableName string ✔️ Название таблицы.
DatabaseName string ✔️ Имя базы данных.
СопоставлениеKind string ✔️ Тип сопоставления. Допустимые значения: csv, , jsonavro, parquetи orc.
СопоставлениеName string ✔️ Имя сопоставления.
СопоставлениеFormattedAsJson string ✔️ Определение сопоставления приема в формате JSON.

Примечание.

  • После создания сопоставление можно ссылаться по его имени в командах приема вместо указания полного сопоставления в рамках команды.
  • Если сопоставление с одинаковым именем создается как в области таблицы, так и в области базы данных, сопоставление в области таблицы будет иметь более высокий приоритет.
  • При приеме в таблицу и ссылке на сопоставление, схема которого не соответствует схеме приема таблицы, операция приема завершится ошибкой.

Примеры

Создание таблицы и базы данных с сопоставлением приема CSV

В следующем примере создается таблица с MyTable сопоставлением Mapping1 приема CSV и базой данных MyDatabase с сопоставлением Mapping2приема CSV.

.create table MyTable ingestion csv mapping "Mapping1"
'['
'   { "column" : "rownumber", "DataType":"int", "Properties":{"Ordinal":"0"}},'
'   { "column" : "rowguid", "DataType":"string", "Properties":{"Ordinal":"1"}}'
']'

.create database MyDatabase ingestion csv mapping "Mapping2"
'['
'   { "column" : "rownumber", "DataType":"int", "Properties":{"Ordinal":"0"}},'
'   { "column" : "rowguid", "DataType":"string", "Properties":{"Ordinal":"1"}}'
']'

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

Имя. Вид Сопоставление База данных Таблица
сопоставление1 CSV [{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}] MyDatabase MyTable
сопоставление2 CSV [{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}] MyDatabase

Создание сопоставления приема с escape-символами

В следующем примере создается таблица test_table с сопоставлением test_mapping_nameприема JSON. Чтобы избежать ошибок, обратные косые косые скобки используются для обхода отдельных кавычки в строках пути JSON.

.create table test_table ingestion json mapping "test_mapping_name"
'['
'{"column":"timeStamp","path":"$[\'timeStamp\']","datatype":"","transform":null},{"column":"name","path":"$[\'name\']","datatype":"","transform":null},{"column":"x-opt-partition-key","path":"$[\'x-opt-partition-key\']","datatype":"","transform":null}'
']'

Связанный контент

  • Подробные описания различных форматов сопоставления приема, таких как CSV, JSON, Avro, Parquet и Orc, см. в разделе "Сопоставления данных".
  • Дополнительные сведения о сопоставлении JSON в качестве источника приема см. в разделе "Сопоставление JSON"
  • Last updated on