› › ›

Процессор Split

Разделяет поле на массив с использованием разделителя. Работает только с текстовыми полями.

Таблица 39. Параметры Split

Имя	Обязательно	По умолчанию	Описание
`field`	да	-	Поле для разделения
`separator`	да	-	Регулярное выражение, соответствующее разделителю, например, `,` или `\s+`
`target_field`	нет	`field`	Поле, которому будет назначено разделяемое значение. По умолчанию поле `field` обновляется на месте
`ignore_missing`	нет	`false`	Если `true` и `field` отсутствуют, процессор спокойно завершается, не изменяя документ
`preserve_trailing`	нет	`false`	Сохраняет пустые хвостовые поля, если они есть.
`description`	нет	-	Описание процессора. Полезно для описания назначения процессора или его конфигурации.
`if`	нет	-	Условно выполнять процессор. См. Условное выполнение процессора.
`ignore_failure`	нет	`false`	Игнорировать ошибки для процессора. См. Обработка ошибок конвейера.
`on_failure`	нет	-	Обрабатывать ошибки для процессора. См. Обработка ошибок конвейера.
`tag`	нет	-	Идентификатор процессора. Полезно для отладки и метрик.

{
  "split": {
    "field": "my_field",
    "separator": "\\s+" 
  }
}

Считает все последовательные символы пробела как один разделитель

Если включен параметр preserve_trailing, любые пустые хвостовые поля ввода будут сохранены. Например, в конфигурации ниже, значение в свойстве my_field будет разделено на массив из пяти элементов ["A", "", "B", "", ""] с двумя пустыми хвостовыми полями. Если бы свойство preserve_trailing не было включено, два пустых хвостовых поля были бы отброшены, что привело бы к массиву из трёх элементов ["A", "", "B"].

{
  "split": {
    "field": "my_field",
    "separator": ",",
    "preserve_trailing": true
  }
}

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/7.17/split-processor.html