Команда .create ingestion mapping

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

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

Разрешения

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

Синтаксис

.createtableTablenameingestionMappingKindmappingMappingNameMappingFormattedAsJson

.createdatabaseDatabasenameingestionMappingKindmappingMappingNameMappingFormattedAsJson

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

Параметры

Имя	Тип	Обязательно	Описание
TableName	string	✔️	Имя таблицы.
DatabaseName	string	✔️	Имя базы данных.
MappingKind	string	✔️	Тип сопоставления. Допустимые значения: csv, json, avro, parquet и orc.
MappingName	string	✔️	Имя сопоставления.
MappingFormattedAsJson	string	✔️	Определение сопоставления приема, отформатированного в виде значения JSON.

Примечание

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

Примеры

.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"}}'
']'

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

Имя	Kind	Сопоставление	База данных	Таблица
сопоставление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

Пример: сопоставление приема .create с escape-символами

.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, см. в разделе Сопоставления данных.