› › ›

Split processor

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

Таблица 44. Параметры 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 включен, любые пустые хвостовые поля на входе сохраняются. Например, в конфигурации ниже, значение A,,B,, в свойстве 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/8.17/split-processor.html