.create ingestion mapping-Befehl

Erstellt eine Aufnahmezuordnung, die einem bestimmten Format und einer bestimmten Tabelle oder Datenbank zugeordnet werden kann.

Wenn eine Zuordnung mit demselben Namen im angegebenen Bereich bereits vorhanden ist, .create tritt ein Fehler auf. Verwenden Sie stattdessen .create-or-alter.

Berechtigungen

Mindestens Datenbankingestor-Berechtigungen sind erforderlich, um eine Datenbankaufnahmezuordnung zu erstellen, und mindestens Tabelleningestorberechtigungen sind erforderlich, um eine Tabellenaufnahmezuordnung zu erstellen.

Syntax

.createtable TableName MappingKind mapping MappingName ingestion MappingFormattedAsJson

.createdatabase DatabaseName MappingKind mapping MappingName ingestion MappingFormattedAsJson

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name	Type	Erforderlich	Beschreibung
TableName	string	✔️	Der Name der Tabelle.
DatabaseName	string	✔️	Der Name der Datenbank.
MappingKind	string	✔️	Der Typ der Zuordnung. Gültige Werte sind csv, json, avro, parquet und orc.
MappingName	string	✔️	Der Name der Zuordnung.
MappingFormattedAsJson	string	✔️	Die Aufnahmezuordnungsdefinition, die als JSON-Wert formatiert ist.

Hinweis

• Nach der Erstellung kann auf die Zuordnung anhand ihres Namens in Aufnahmebefehlen verwiesen werden, anstatt die vollständige Zuordnung als Teil des Befehls anzugeben.
• Wenn eine Zuordnung mit demselben Namen sowohl im Tabellenbereich als auch im Datenbankbereich erstellt wird, hat die Zuordnung im Tabellenbereich eine höhere Priorität.
• Wenn Sie eine Tabelle aufnehmen und auf eine Zuordnung verweisen, deren Schema nicht mit dem aufgenommenen Tabellenschema übereinstimmt, schlägt der Aufnahmevorgang fehl.

Beispiele

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

Output

Name	Variante	Zuordnung	Datenbank	Tabelle
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

Beispiel: .create ingestion mapping with escape characters

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

Zugehöriger Inhalt

• Ausführliche Beschreibungen verschiedener Aufnahmezuordnungsformate wie CSV, JSON, Avro, Parkett und Orc finden Sie unter Datenzuordnungen.