› › ›

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

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

Поддерживаемые типы включают: 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 будет обновлено со значением необработанного поля.

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

Имя	Обязательно	Значение по умолчанию	Описание
`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/7.17/convert-processor.html