Freigeben über

.create-or-alter ingestion mapping-Befehl

  • Artikel

Gilt für: ✅Microsoft Fabric✅Azure Data Explorer

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

Wenn die Aufnahmezuordnung nicht vorhanden ist, erstellt der Befehl sie. Wenn die Aufnahmezuordnung bereits vorhanden ist, ändert der Befehl sie.

Hinweis

Neue Spalten, die in einer Aufnahmezuordnung eingeführt wurden, die in der Quelltabelle nicht vorhanden sind, werden der Tabelle während der anfänglichen Datenaufnahme für diese Spalte hinzugefügt. Dieses Verhalten wird nur für die Aufnahme in die Warteschlange unterstützt und hängt davon ab, einen gültigen Datentyp für die Spalte anzugeben.

Berechtigungen

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

Syntax

.create-or-altertable TableName MappingKind mapping MappingName ingestion MappingFormattedAsJson

.create-or-alterdatabase 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.

Beispiel

.create table MyTable ingestion csv mapping "Mapping1"
'['
'   { "column" : "rownumber", "DataType":"int", "Properties":{"Ordinal":"0"}},'
'   { "column" : "rowguid", "DataType":"string", "Properties":{"Ordinal":"1"}}'
']'

.create-or-alter table MyTable ingestion json mapping "Mapping1"
'['
'    { "column" : "rownumber", "datatype" : "int", "Properties":{"Path":"$.rownumber"}},'
'    { "column" : "rowguid", "Properties":{"Path":"$.rowguid"}}'
']'

Output

Name Variante Zuordnung Datenbank Tabelle
Mapping1 JSON [{"Properties":{"Path":"$.rownumber"},"column":"rownumber","datatype":"int"},{"Properties":{"Path":"$.rowguid"},"column":"rowguid","datatype":"}] MyDatabase MyTable

Zugehöriger Inhalt

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