Sdílet prostřednictvím

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

  • Článek

Platí pro: ✅Microsoft Fabric✅Azure Data Explorer

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.