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 tabulek se vyžadují alespoň oprávnění Ingestoru tabulky.
Syntaxe
.create
table
TableName MappingKind mapping
MappingName ingestion
MappingFormattedAsJson
.create
database
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 , , avro json , parquet a 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ří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
Název | Kind | mapování. | Databáze | Table |
---|---|---|---|---|
mapování 1 | CSV | [{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}] |
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}] |
MyDatabase |
Příklad: .create ingestování mapování 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.
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro