Kommandot .create ingestion mapping

Skapar en inmatningsmappning som kan associeras med ett visst format och en specifik tabell eller databas.

Om det redan finns .create en mappning med samma namn i det angivna omfånget misslyckas. Använd .create-or-alter i stället.

Behörigheter

Databasingestor-behörigheter krävs minst för att skapa en databasinmatningsmappning, och minst Tabellingestor-behörigheter krävs för att skapa en mappning av tabellinmatning.

Syntax

.createtableTablenameingestionMappingKindmappingMappingNameMappingFormattedAsJson

.createdatabaseDatabasenameingestionMappingKindmappingMappingNameMappingFormattedAsJson

Läs mer om syntaxkonventioner.

Parametrar

Namn	Typ	Obligatorisk	Beskrivning
TableName	string	✔️	Namnet på tabellen.
Databasename	string	✔️	Namnet på databasen.
MappingKind	string	✔️	Typen av mappning. Giltiga värden är csv, json, avro, parquetoch orc.
MappingName	string	✔️	Namnet på mappningen.
MappingFormattedAsJson	string	✔️	Inmatningsmappningsdefinitionen formaterad som ett JSON-värde.

Anteckning

• När mappningen har skapats kan den refereras till med namnet i inmatningskommandon, i stället för att ange den fullständiga mappningen som en del av kommandot.
• Om en mappning med samma namn skapas i både tabellomfånget och databasomfånget har mappningen i tabellomfånget högre prioritet.
• När du matar in i en tabell och refererar till en mappning vars schema inte matchar det inmatade tabellschemat misslyckas inmatningsåtgärden.

Exempel

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

Resultat

Name	Variant	Mappning	Databas	Tabell
mapping1	CSV	[{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}]	MyDatabase	MyTable
mapping2	CSV	[{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}]	MyDatabase

Exempel: .create-inmatningsmappning med escape-tecken

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

Relaterat innehåll

• Detaljerade beskrivningar av olika inmatningsmappningsformat som CSV, JSON, Avro, Parquet och Orc finns i Datamappningar.