W3CLOGFILE-Zuordnung

Verwenden Sie W3CLOGFILE Zuordnung, um eingehende Daten Spalten in Tabellen zuzuordnen, wenn die Erfassungsquelldatei W3CLOGFILE Format aufweist.

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 über Datenzuordnungen.

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

Eigenschaft	Typ	BESCHREIBUNG
Feld	string	Name des Felds im W3CLOGFILE Protokolldatensatz.
ConstValue	string	Der konstante Wert, der für eine Spalte anstelle eines Werts in der W3CLOGFILE-Datei verwendet werden soll.
Transformieren	string	Transformation, die mit Zuordnungstransformationen auf den Inhalt angewendet werden soll.

Hinweis

Die einzigen unterstützten Transformationen für W3CLOGFILE Format sind SourceLineNumber und SourceLocation.

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": "Date",          "Properties": {"Field": "date"}},
   {"Column": "Time",          "Properties": {"Field": "time"}},
   {"Column": "IP",            "Properties": {"Field": "s-ip"}},
   {"Column": "ClientMethod",  "Properties": {"Field": "cs-method"}},
   {"Column": "ClientQuery",   "Properties": {"Field": "cs-uri-query"}},
   {"Column": "ServerPort",    "Properties": {"Field": "s-port"}},
   {"Column": "ClientIP",      "Properties": {"Field": "c-ip"}},
   {"Column": "UserAgent",     "Properties": {"Field": "cs(User-Agent)"}},
   {"Column": "Referer",       "Properties": {"Field": "cs(Referer)"}},
   {"Column": "Status",        "Properties": {"Field": "sc-status"}},
   {"Column": "ResponseBytes", "Properties": {"Field": "sc-bytes"}},
   {"Column": "RequestBytes",  "Properties": {"Field": "cs-bytes"}},
   {"Column": "TimeTaken",     "Properties": {"Field": "time-taken"}}
]

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

.ingest into Table123 (@"source1", @"source2")
  with
  (
      format = "w3clogfile",
      ingestionMapping =
      ```
      [
         {"Column": "column_a", "Properties": {"Field": "field1"}},
         {"Column": "column_b", "Properties": {"Field": "field2"}}
      ]
      ```
  )

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="w3clogfile",
        ingestionMappingReference = "Mapping_Name"
    )

Identitätszuordnung

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

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