Příkaz mapování příjmu dat .create-or-alter

Vytvoří nebo změní mapování příjmu dat, které může být přidruženo k určité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 do tabulky přidají během počátečního příjmu dat pro tento sloupec. Toto chování je podporováno pouze pro příjem dat ve frontě a závisí na zadání platného datového typu pro sloupec.

Oprávnění

K vytvoření mapování příjmu dat databáze jsou vyžadována alespoň oprávnění Nástroje pro správu databáze a k vytvoření mapování příjmu dat tabulky jsou vyžadována alespoň oprávnění nástroje Table Ingestor .

Syntax

.create-or-altertableTablenameingestionMappingKindmappingMappingNameMappingFormattedAsJson

.create-or-alterdatabaseDatabasenameingestionMappingKindmappingMappingNameMappingFormattedAsJson

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

Parametry

Název	Typ	Vyžadováno	Popis
TableName	string	✔️	Název tabulky.
Databasename	string	✔️	Název databáze.
MappingKind	string	✔️	Typ mapování. Platné hodnoty jsou CSV, JSON, avro, parqueta orc.
Mappingname	string	✔️	Název mapování.
MappingFormattedAsJson	string	✔️	Definice mapování příjmu dat formátovaná jako hodnota JSON.

Poznámka

• Po vytvoření může být mapování odkazováno jeho názvem v příkazech pro příjem dat místo zadání úplného mapování jako součásti příkazu.
• Pokud se v oboru tabulky i v oboru databáze vytvoří mapování se stejným názvem, bude mít mapování v oboru tabulky vyšší prioritu.
• Při ingestování do tabulky a odkazování na mapování, jehož schéma neodpovídá schématu ingestované tabulky, operace ingestace 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

Name	Druh	Mapování	Databáze	Tabulka
mapování1	JSON	[{"Properties":{"Path":"$.rownumber"},"column":"rownumber","datatype":"int"},{"Properties":{"Path":"$.rowguid"},"column":"rowguid","datatype":""}]	Databáze 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.