Back to Elasticsearch

Enrich processor [enrich-processor]

docs/reference/ingest-processor/enrich-processor.md

9.5.02.9 KB
Original Source

Enrich processor [enrich-processor]

The enrich processor can enrich documents with data from another index. See enrich data section for more information about how to set this up.

$$$enrich-options$$$

NameRequiredDefaultDescription
policy_nameyes-The name of the enrich policy to use.
fieldyes-The field in the input document that matches the policies match_field used to retrieve the enrichment data. Supports template snippets.
target_fieldyes-Field added to incoming documents to contain enrich data. This field contains both the match_field and enrich_fields specified in the enrich policy. Supports template snippets.
ignore_missingnofalseIf true and field does not exist, the processor quietly exits without modifying the document
overridenotrueIf processor will update fields with pre-existing non-null-valued field. When set to false, such fields will not be touched.
max_matchesno1The maximum number of matched documents to include under the configured target field. The target_field will be turned into a json array if max_matches is higher than 1, otherwise target_field will become a json object. In order to avoid documents getting too large, the maximum allowed value is 128.
shape_relationnoINTERSECTSA spatial relation operator used to match the geoshape of incoming documents to documents in the enrich index. This option is only used for geo_match enrich policy types. See Spatial Relations for operators and more information.
descriptionno-Description of the processor. Useful for describing the purpose of the processor or its configuration.
ifno-Conditionally execute the processor. See Conditionally run a processor.
ignore_failurenofalseIgnore failures for the processor. See Handling pipeline failures.
on_failureno-Handle failures for the processor. See Handling pipeline failures.
tagno-Identifier for the processor. Useful for debugging and metrics.