JSON-Zuordnung

Artikel
02/13/2024

Verwenden Sie JSON-Zuordnung, um eingehende Daten Spalten in Tabellen zuzuordnen, wenn Ihre Erfassungsquelldatei im JSON-Format vorliegt.

Jedes Element in der Zuordnungsliste definiert die Zuordnung für eine bestimmte Spalte. Diese Elemente werden aus drei Eigenschaften erstellt: column, datatypeund properties. Weitere Informationen finden Sie in der Übersicht zu Datenzuordnungen.

Jedes JSON-Zuordnungselement muss eine der folgenden optionalen Eigenschaften enthalten:

Eigenschaft	Typ	BESCHREIBUNG
`Path`	`string`	Wenn der Wert mit `$` beginnt, wird er als JSON-Pfad zum Feld im JSON-Dokument interpretiert, das zum Inhalt der Spalte in der Tabelle wird. Der JSON-Pfad, der das gesamte Dokument angibt, ist `$`. Wenn der Wert nicht mit `$` beginnt, wird er als konstanter Wert interpretiert. JSON-Pfade, die Sonderzeichen enthalten, müssen wie folgt mit Escapezeichen versehen werden: ['Eigenschaftenname']. Weitere Informationen finden Sie unter JSONPath-Syntax.
ConstValue	`string`	Der konstante Wert, der für eine Spalte anstelle eines Werts in der JSON-Datei verwendet werden soll.
Transformieren	`string`	Transformation, die mit Zuordnungstransformationen auf den Inhalt angewendet werden soll.

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, wenn 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 im Batch verarbeitet. Je differenzierter die Erfassungszuordnungseigenschaften verwendet werden, z. B. unterschiedliche ConstValue-Werte, desto fragmentierter wird die Erfassung, was zu Leistungseinbußen führen kann.

Beispiele

[
  {"Column": "event_timestamp", "Properties": {"Path": "$.Timestamp"}},
  {"Column": "event_name",      "Properties": {"Path": "$.Event.Name"}},
  {"Column": "event_type",      "Properties": {"Path": "$.Event.Type"}},
  {"Column": "source_uri",      "Properties": {"Transform": "SourceLocation"}},
  {"Column": "source_line",     "Properties": {"Transform": "SourceLineNumber"}},
  {"Column": "event_time",      "Properties": {"Path": "$.Timestamp", "Transform": "DateTimeFromUnixMilliseconds"}},
  {"Column": "ingestion_time",  "Properties": {"ConstValue": "2021-01-01T10:32:00"}},
  {"Column": "full_record",     "Properties": {"Path": "$"}}
]

Die obige Zuordnung wird als JSON-Zeichenfolge serialisiert, wenn sie als Teil des .ingest Verwaltungsbefehls bereitgestellt wird.

.ingest into Table123 (@"source1", @"source2")
  with
  (
      format = "json",
      ingestionMapping =
      ```
      [
        {"Column": "column_a", "Properties": {"Path": "$.Obj.Property"}},
        {"Column": "column_b", "Properties": {"Path": "$.Property"}},
        {"Column": "custom_column", "Properties": {"Path": "$.[\'Property name with space\']"}}
      ]
      ```
  )

Vorab erstellte Zuordnung

Wenn die Zuordnung vorab erstellt wurde, verweisen Sie im Verwaltungsbefehl auf die Zuordnung anhand des .ingest Namens.

.ingest into Table123 (@"source1", @"source2")
    with
    (
        format="json",
        ingestionMappingReference = "Mapping_Name"
    )

Identitätszuordnung

Verwenden Sie die JSON-Zuordnung während der Erfassung, ohne ein Zuordnungsschema zu definieren (siehe Identitätszuordnung).

.ingest into Table123 (@"source1", @"source2")
    with
    (
        format="json"
    )

Kopieren der JSON-Zuordnung

Mithilfe des folgenden Prozesses können Sie die JSON-Zuordnung einer vorhandenen Tabelle kopieren und eine neue Tabelle mit derselben Zuordnung erstellen:

Führen Sie den folgenden Befehl für die Tabelle aus, deren Zuordnung Sie kopieren möchten:

.show table TABLENAME ingestion json mappings
| extend formatted_mapping = strcat("'",replace_string(Mapping, "'", "\\'"),"'")
| project formatted_mapping

Verwenden Sie die Ausgabe des obigen Befehls, um eine neue Tabelle mit derselben Zuordnung zu erstellen:
```
.create table TABLENAME ingestion json mapping "TABLENAME_Mapping" RESULT_OF_ABOVE_CMD
```

Freigeben über