.create ingestion mapping-Befehl
Gilt für: ✅Microsoft Fabric✅Azure Data Explorer
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 schlägt ein Fehler fehl. 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
Erstellen einer Tabelle und Datenbank mit CSV-Erfassungszuordnung
Im folgenden Beispiel wird eine Tabelle MyTable mit CSV-Erfassungszuordnung Mapping1 und einer Datenbank MyDatabase mit CSV-Erfassungszuordnung Mapping2erstellt.
.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 |
Erstellen einer Aufnahmezuordnung mit Escapezeichen
Im folgenden Beispiel wird eine Tabelle test_table mit JSON-Erfassungszuordnung test_mapping_nameerstellt. Um Fehler zu vermeiden, werden umgekehrte Schrägstriche verwendet, um einzelne Anführungszeichen in den JSON-Pfadzeichenfolgen zu escapen.
.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.
- Weitere Informationen zur JSON-Zuordnung als Aufnahmequelle finden Sie unter JSON-Zuordnung