сопоставление W3CLOGFILE

Используйте сопоставление W3CLOGFILE для сопоставления входящих данных со столбцами в таблицах, если исходный файл приема данных имеет W3CLOGFILE формат.

Каждый элемент в списке сопоставления определяет сопоставление для определенного столбца. Эти элементы создаются из трех свойств: column, datatypeи properties. Дополнительные сведения см. в обзоре сопоставлений данных.

Каждый элемент сопоставления W3CLOGFILE должен содержать одно из следующих необязательных свойств:

Свойство Тип Описание
Поле string Имя поля в записи журнала W3CLOGFILE.
ConstValue string Значение константы, используемое для столбца, а не какого-то значения в файле W3CLOGFILE.
Преобразование string Преобразование, которое должно применяться к содержимому с преобразованиями сопоставления.

Примечание

Единственными поддерживаемыми преобразованиями для формата W3CLOGFILE являются SourceLineNumber и SourceLocation.

Важно!

Для приема в очереди:

  • Если таблица, на которую ссылается сопоставление, не существует в базе данных, она создается автоматически, если для всех столбцов указаны допустимые типы данных.
  • Если столбец, указанный в сопоставлении, не существует в таблице, он автоматически добавляется в таблицу в качестве последнего столбца при первом приеме данных для этого столбца при наличии допустимого типа данных для столбца. Чтобы добавить новые столбцы в сопоставление, используйте команду .alter ingestion mapping.
  • Данные пакетируются с помощью свойств приема. Чем больше различных используемых свойств сопоставления приема, таких как различные значения ConstValue, тем более фрагментарным становится прием, что может привести к снижению производительности.

Примеры

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

Приведенное выше сопоставление сериализуется как строка JSON, когда она предоставляется в составе .ingest команды управления.

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

Предварительно созданное сопоставление

При предварительном создании сопоставления укажите ссылку на сопоставление по имени в команде .ingest управления.

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

Сопоставление удостоверений

Используйте сопоставление W3CLOGFILE во время приема без определения схемы сопоставления (см. сопоставление удостоверений).

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