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

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

Изменяет существующее сопоставление приема, связанное с определенной таблицей или базой данных, и определенным форматом (замена полного сопоставления).

Примечание.

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

Разрешения

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

Синтаксис

.altertable TableName MappingKind mapping MappingName ingestion ArrayOfMappingObjects

.alterdatabase DatabaseName MappingKind mapping MappingName ingestion ArrayOfMappingObjects

Примечание.

На это сопоставление можно ссылаться по его имени, выполнив команды приема, вместо указания полного сопоставления в составе команды.

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

Параметры

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

Примеры

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

.alter table MyTable ingestion json mapping "Mapping1"
```
[
    { "column" : "rownumber", "DataType" : "int", "Properties":{"Path":"$.rownumber"}},
    { "column" : "rowguid", "DataType":"string", "Properties":{"Path":"$.rowguid"}}
]
```

.alter 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}]
сопоставление2	CSV	[{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}]