Příkaz .create-or-alter ingestion mapping

Vytvoří nebo změní mapování příjmu dat, které může být přidruženo ke konkrétnímu formátu a konkrétní tabulce nebo databázi.

Pokud mapování příjmu dat neexistuje, příkaz ho vytvoří. Pokud mapování příjmu dat již existuje, příkaz ho upraví.

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í

K vytvoření mapování příjmu dat databáze se vyžadují alespoň oprávnění Ingestoru databáze a k vytvoření mapování příjmu tabulek se vyžadují alespoň oprávnění Ingestoru tabulky.

Syntaxe

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

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

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í.
MappingFormattedAsJson	string	✔️	Definice mapování příjmu dat naformátovaná jako hodnota JSON.

Poznámka:

• Po vytvoření je možné na mapování odkazovat jeho názvem v příkazech pro příjem dat, místo abyste v rámci příkazu zadali úplné mapování.
• Pokud se v oboru tabulky i v oboru databáze vytvoří mapování se stejným názvem, mapování v oboru tabulky bude mít vyšší prioritu.
• Při ingestování do tabulky a odkazování na mapování, jehož schéma neodpovídá schématu ingestované tabulky, operace ingestování selže.

Příklad

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

Výstup

Název	Kind	mapování.	Databáze	Table
mapování 1	JSON	[{"Vlastnosti":{"Cesta":"$.rownumber"},"column":"rownumber","datatype":"int"},{"Properties":{"Path":"$.rowguid"},"column":"rowguid","datatype":"}]	MyDatabase	MyTable

Související obsah

• Podrobné popisy různých formátů mapování příjmu dat, jako jsou CSV, JSON, Avro, Parquet a Orc, najdete v tématu Mapování dat.