Příkaz .alter ingestion mapping

Platí pro: ✅Microsoft Fabric✅Azure Data Explorer

Změní existující mapování příjmu dat přidružené ke konkrétní tabulce nebo databázi a určitému formátu (úplné nahrazení mapování).

Poznámka:

Nové sloupce zavedené v mapování příjmu dat, které nejsou ve zdrojové tabulce, se při počátečním příjmu dat pro tento sloupec přidají do tabulky. Toto chování je podporováno pouze pro příjem dat ve frontě a je podmíněno určením platného datového typu pro sloupec.

Oprávnění

Příkaz k úpravě mapování příjmu dat databáze vyžaduje alespoň oprávnění databázového ingestoru a příkaz k úpravě mapování příjmu tabulek vyžaduje alespoň oprávnění Ingestoru tabulky.

Syntaxe

.altertable TableName MappingKind mapping MappingName ingestion ArrayOfMappingObjects

.alterdatabase DatabaseName MappingKind mapping MappingName ingestion ArrayOfMappingObjects

Poznámka:

Na toto mapování může odkazovat jeho název příkazy příjmu dat, místo abyste v rámci příkazu zadali úplné mapování.

Přečtěte si další informace o konvencích syntaxe.

Parametry

Název	Type	Požadováno	Popis
TableName	string	✔️	Název tabulky.
Název databáze	string	✔️	Název databáze.
MappingKind	string	✔️	Typ mapování. Platné hodnoty jsou CSV, , avroJSON, parqueta orc.
MappingName	string	✔️	Název mapování.
ArrayOfMappingObjects	string	✔️	Serializované pole s jedním nebo více mapovacími objekty definovanými.

Příklady

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

Výstup

Název	Kind	mapování.
mapování 1	CSV	[{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}]
mapování2	CSV	[{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}]