Polecenie mapowania pozyskiwania .alter

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer

Zmienia istniejące mapowanie pozyskiwania skojarzone z określoną tabelą/bazą danych i określonym formatem (pełne mapowanie zastępuje).

Uwaga

Nowe kolumny wprowadzone w mapowaniu pozyskiwania, które nie są obecne w tabeli źródłowej, zostaną dodane do tabeli podczas początkowego pozyskiwania danych dla tej kolumny. To zachowanie jest obsługiwane tylko w przypadku pozyskiwania w kolejce i zależy od określenia prawidłowego typu danych dla kolumny.

Uprawnienia

Polecenie zmiany mapowania pozyskiwania bazy danych wymaga co najmniej uprawnień ingestor bazy danych, a polecenie zmiany mapowania pozyskiwania tabeli wymaga co najmniej uprawnień ingestor tabeli.

Składnia

.altertable TableName MappingKind mapping MappingName ingestion ArrayOfMappingObjects

.alterdatabase DatabaseName MappingKind mapping MappingName ingestion ArrayOfMappingObjects

Uwaga

To mapowanie można odwoływać się do jego nazwy za pomocą poleceń pozyskiwania, zamiast określać pełne mapowanie w ramach polecenia.

Dowiedz się więcej na temat konwencji składni.

Parametry

Nazwisko	Type	Wymagania	opis
TableName	string	✔️	Nazwa tabeli.
Nazwa bazy danych	string	✔️	Nazwa bazy danych.
MappingKind	string	✔️	Typ mapowania. Prawidłowe wartości to CSV, , avroJSON, parquet, i orc.
Nazwa mapowania	string	✔️	Nazwa mapowania.
ArrayOfMappingObjects	string	✔️	Serializowana tablica z zdefiniowanymi co najmniej jednym obiektem mapowania.

Przykłady

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

Wyjście

Nazwisko	Rodzaj	Mapowanie
mapowanie1	CSV	[{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}]
mapowanie2	CSV	[{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}]