Příkaz .create pro mapování příjmu dat

Vytvoří mapování příjmu dat, které lze přidružit ke konkrétnímu formátu a konkrétní tabulce nebo databázi.

Pokud mapování se stejným názvem v daném oboru již existuje, .create selže. Místo toho použijte .create-or-alter.

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 dat tabulky se vyžadují alespoň oprávnění Ingestoru tabulky.

Syntax

.createtableTablenameingestionMappingKindmappingMappingNameMappingFormattedAsJson

.createdatabaseDatabasenameingestionMappingKindmappingMappingNameMappingFormattedAsJson

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 naformátovaná jako hodnota JSON.

Poznámka

• Po vytvoření může mapování odkazovat na jeho název 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 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říklady

.create table MyTable ingestion csv mapping "Mapping1"
'['
'   { "column" : "rownumber", "DataType":"int", "Properties":{"Ordinal":"0"}},'
'   { "column" : "rowguid", "DataType":"string", "Properties":{"Ordinal":"1"}}'
']'

.create database MyDatabase ingestion csv mapping "Mapping2"
'['
'   { "column" : "rownumber", "DataType":"int", "Properties":{"Ordinal":"0"}},'
'   { "column" : "rowguid", "DataType":"string", "Properties":{"Ordinal":"1"}}'
']'

Výstup

Name	Druh	Mapování	Databáze	Tabulka
mapování1	CSV	[{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}]	Databáze MyDatabase	Mytable
mapování2	CSV	[{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}]	Databáze MyDatabase

Příklad: Mapování příjmu dat .create s řídicími znaky

.create table test_table ingestion json mapping "test_mapping_name"
'['
'{"column":"timeStamp","path":"$[\'timeStamp\']","datatype":"","transform":null},{"column":"name","path":"$[\'name\']","datatype":"","transform":null},{"column":"x-opt-partition-key","path":"$[\'x-opt-partition-key\']","datatype":"","transform":null}'
']'

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.