› › ›

Процессор gsub

Преобразует строковое поле, применяя к нему регулярное выражение и замену. Если поле представляет собой массив строк, все члены массива будут преобразованы. Если встречаются значения, отличные от строк, процессор сгенерирует исключение.

Таблица 25. Параметры процессора gsub

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

{
  "gsub": {
    "field": "field1",
    "pattern": "\\.",
    "replacement": "-"
  }
}

© 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/gsub-processor.html