› › ›

Процессор преобразования

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

Поддерживаемые типы включают: integer, long, float, double, string, boolean, ip и auto.

Указание boolean установит поле в значение true, если его строковое значение равно true (регистр игнорируется), в значение false, если его строковое значение равно false (регистр игнорируется), в противном случае будет брошено исключение.

Указание ip установит целевое поле в значение field, если оно содержит допустимый IPv4 или IPv6 адрес, который можно индексировать в поле типа IP.

Указание auto попытается преобразовать строковое значение field в ближайший нестроковый, не-IP тип. Например, поле со значением "true" будет преобразовано в соответствующий булевый тип: true. Обратите внимание, что float имеет приоритет над double в auto. Значение "242.15" будет «автоматически» преобразовано в 242.15 типа float. Если предоставленное поле не может быть надлежащим образом преобразовано, процессор всё равно успешно обработает его и оставит значение поля как есть. В этом случае, target_field будет обновлено значением не преобразованного поля.

Таблица 9. Опции преобразования

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

PUT _ingest/pipeline/my-pipeline-id
{
  "description": "converts the content of the id field to an integer",
  "processors" : [
    {
      "convert" : {
        "field" : "id",
        "type": "integer"
      }
    }
  ]
}

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