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

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

  • Статья

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

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

Если сопоставление приема не существует, команда создаст ее. Если сопоставление приема уже существует, команда изменит ее.

Примечание.

Новые столбцы, представленные в сопоставлении приема данных, которые отсутствуют в исходной таблице, будут добавлены в таблицу во время приема исходных данных для этого столбца. Это поведение поддерживается только для приема в очереди и зависит от указания допустимого типа данных для столбца.

Разрешения

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

Синтаксис

.create-or-altertable TableName ingestion MappingKind mapping MappingName MappingFormattedAsJson

.create-or-alterdatabase DatabaseName MappingKind mapping MappingName ingestion MappingFormattedAsJson

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

Параметры

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

Примечание.

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

Пример

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

.create-or-alter table MyTable ingestion json mapping "Mapping1"
'['
'    { "column" : "rownumber", "datatype" : "int", "Properties":{"Path":"$.rownumber"}},'
'    { "column" : "rowguid", "Properties":{"Path":"$.rowguid"}}'
']'

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

Имя. Вид Сопоставление База данных Таблица
сопоставление1 JSON [{"Properties":{"Path":"$.rownumber"},"column":"rownumber","datatype":"int"},{"Properties":"Path":"Path":"$.rowguid"},"column":"rowguid","datatype":"}] MyDatabase MyTable

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

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