CSV-Zuordnung
Verwenden Sie die CSV-Zuordnung, um eingehende Daten Spalten innerhalb von Tabellen zuzuordnen, wenn Ihre Erfassungsquelldatei eines der folgenden durch Trennzeichen getrennten tabellarischen Formate ist: CSV, TSV, PSV, SCSV, SOHsv, TXT und RAW. Weitere Informationen finden Sie unter Unterstützte Datenformate.
Jedes Element in der Zuordnungsliste definiert die Zuordnung für eine bestimmte Spalte. Diese Elemente werden aus drei Eigenschaften erstellt: column
, datatype
und properties
. Weitere Informationen finden Sie in der Übersicht über Datenzuordnungen.
Jedes CSV-Zuordnungselement muss eine der folgenden optionalen Eigenschaften enthalten:
Eigenschaft | Typ | BESCHREIBUNG |
---|---|---|
Ordinal | int |
Die Nummer der Spaltenreihenfolge in CSV. |
ConstValue | string |
Der konstante Wert, der für eine Spalte anstelle eines Werts in der CSV-Datei verwendet werden soll. |
Transformieren | string |
Transformation, die mit Zuordnungstransformationen auf den Inhalt angewendet werden soll. Die einzige unterstützte Transformation von ist SourceLocation . |
Hinweis
- Wenn
ConstValue
oderSourceLocation
transformation verwendet werden,Ordinal
muss nicht festgelegt sein. - Für TXT- und RAW-Formate kann nur
Ordinal
0 zugeordnet werden, da Text als einzelne Zeilenspalte behandelt wird.
Wichtig
Für die Erfassung in die Warteschlange:
- Wenn die Tabelle, auf die in der Zuordnung verwiesen wird, in der Datenbank nicht vorhanden ist, wird sie automatisch erstellt, da für alle Spalten gültige Datentypen angegeben werden.
- Wenn eine Spalte, auf die in der Zuordnung verwiesen wird, in der Tabelle nicht vorhanden ist, wird sie automatisch als letzte Spalte hinzugefügt, wenn daten zum ersten Mal für diese Spalte erfasst werden, sofern ein gültiger Datentyp für die Spalte angegeben ist. Um einer Zuordnung neue Spalten hinzuzufügen, verwenden Sie den Befehl .alter ingestion mapping.
- Daten werden mithilfe von Erfassungseigenschaften in Batches verarbeitet. Je unterschiedlicher die verwendeten Erfassungszuordnungseigenschaften, z. B. unterschiedliche ConstValue-Werte, verwendet werden, desto fragmentierter wird die Erfassung, was zu Leistungseinbußen führen kann.
Beispiele
[
{"Column": "event_time", "Properties": {"Ordinal": "0"}},
{"Column": "event_name", "Properties": {"Ordinal": "1"}},
{"Column": "event_type", "Properties": {"Ordinal": "2"}},
{"Column": "ingestion_time", "Properties": {"ConstValue": "2023-01-01T10:32:00"}}
{"Column": "source_location", "Properties": {"Transform": "SourceLocation"}}
]
Die obige Zuordnung wird als JSON-Zeichenfolge serialisiert, wenn sie im Rahmen des .ingest
Verwaltungsbefehls bereitgestellt wird.
.ingest into Table123 (@"source1", @"source2")
with
(
format="csv",
ingestionMapping =
```
[
{"Column": "event_time", "Properties": {"Ordinal": "0"}},
{"Column": "event_name", "Properties": {"Ordinal": "1"}},
{"Column": "event_type", "Properties": {"Ordinal": "2"}},
{"Column": "ingestion_time", "Properties": {"ConstValue": "2023-01-01T10:32:00"}},
{"Column": "source_location", "Properties": {"Transform": "SourceLocation"}}
]
```
)
Vorab erstellte Zuordnung
Wenn die Zuordnung vorab erstellt wurde, verweisen Sie im Verwaltungsbefehl anhand des Namens auf die .ingest
Zuordnung.
.ingest into Table123 (@"source1", @"source2")
with
(
format="csv",
ingestionMappingReference = "MappingName"
)
Identitätszuordnung
Verwenden Sie die CSV-Zuordnung während der Erfassung, ohne ein Zuordnungsschema zu definieren (siehe Identitätszuordnung).
.ingest into Table123 (@"source1", @"source2")
with
(
format="csv"
)
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für