сопоставление 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"
)
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по