Dela via


W3CLOGFILE mappning

Använd W3CLOGFILE mappning för att mappa inkommande data till kolumner i tabeller när källfilen för inmatning är i W3CLOGFILE format.

Varje element i mappningslistan definierar mappningen för en specifik kolumn. Dessa element konstrueras från tre egenskaper: column, datatypeoch properties. Läs mer i översikten över datamappningar.

Varje W3CLOGFILE mappningselement måste innehålla någon av följande valfria egenskaper:

Egenskap Typ Description
Fält string Namnet på fältet i W3CLOGFILE loggposten.
ConstValue string Det konstanta värdet som ska användas för en kolumn i stället för något värde i filen W3CLOGFILE.
Transformering string Transformering som ska tillämpas på innehållet med mappningstransformeringar.

Anteckning

De enda omvandlingar som stöds för W3CLOGFILE format är SourceLineNumber och SourceLocation.

Viktigt

För köad inmatning:

  • Om tabellen som refereras i mappningen inte finns i databasen skapas den automatiskt, eftersom giltiga datatyper anges för alla kolumner.
  • Om en kolumn som refereras till i mappningen inte finns i tabellen läggs den automatiskt till i tabellen som den sista kolumnen första gången data matas in för den kolumnen, givet att en giltig datatyp har angetts för kolumnen. Om du vill lägga till nya kolumner i en mappning använder du kommandot .alter ingestion mapping .
  • Data batchindelades med inmatningsegenskaper. Ju mer distinkta egenskaper för inmatningsmappning som används, till exempel olika ConstValue-värden, desto mer fragmenterad blir inmatningen, vilket kan leda till prestandaförsämring.

Exempel

[
   {"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"}}
]

Mappningen ovan serialiseras som en JSON-sträng när den tillhandahålls som en del av .ingest hanteringskommandot.

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

Förskapad mappning

När mappningen har skapats i förväg refererar du till mappningen efter namn i hanteringskommandot .ingest .

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

Identitetsmappning

Använd W3CLOGFILE mappning under inmatning utan att definiera ett mappningsschema (se identitetsmappning).

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