.create ingestion mapping-Befehl

Erstellt eine Erfassungszuordnung, 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 Datenbank-Ingestor-Berechtigungen sind erforderlich, um eine Datenbankerfassungszuordnung zu erstellen, und mindestens Tabelleningestorberechtigungen sind erforderlich, um eine Tabellenerfassungszuordnung zu erstellen.

Syntax

.createtableTablenameingestionMappingKindmappingMappingNameMappingFormattedAsJson

.createdatabaseDatabasenameingestionMappingKindmappingMappingNameMappingFormattedAsJson

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

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

Hinweis

• Nach der Erstellung kann durch ihren Namen in Erfassungsbefehlen auf die Zuordnung verwiesen werden, anstatt die vollständige Zuordnung als Teil des Befehls anzugeben.
• Wenn eine Zuordnung mit demselben Namen sowohl im Tabellen- als auch im Datenbankbereich erstellt wird, hat die Zuordnung im Tabellenbereich eine höhere Priorität.
• Beim Erfassen in einer Tabelle und beim Verweisen auf eine Zuordnung, deren Schema nicht mit dem erfassten Tabellenschema übereinstimmt, schlägt der Erfassungsvorgang 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"}}'
']'

Ausgabe

Name	Art	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: Erfassungszuordnung .create mit Escapezeichen

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

Verwandte Inhalte

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