Команда сопоставления приема .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"