原英文版地址: https://www.elastic.co/guide/en/elasticsearch/reference/7.7/ignore-malformed.html, 原文档版权归 www.elastic.co 所有
本地英文版地址: ../en/ignore-malformed.html
重要: 此版本不会发布额外的bug修复或文档更新。最新信息请参考 当前版本文档。
Elasticsearch Guide [7.7] » Mapping » Mapping parameters » ignore_malformed
« ignore_above index »

ignore_malformededit

Sometimes you don’t have much control over the data that you receive. One user may send a login field that is a date, and another sends a login field that is an email address.

Trying to index the wrong datatype into a field throws an exception by default, and rejects the whole document. The ignore_malformed parameter, if set to true, allows the exception to be ignored. The malformed field is not indexed, but other fields in the document are processed normally.

For example:

PUT my_index
{
  "mappings": {
    "properties": {
      "number_one": {
        "type": "integer",
        "ignore_malformed": true
      },
      "number_two": {
        "type": "integer"
      }
    }
  }
}

PUT my_index/_doc/1
{
  "text":       "Some text value",
  "number_one": "foo" 
}

PUT my_index/_doc/2
{
  "text":       "Some text value",
  "number_two": "foo" 
}

This document will have the text field indexed, but not the number_one field.

This document will be rejected because number_two does not allow malformed values.

The ignore_malformed setting is currently supported by the following mapping types:

Numeric
long, integer, short, byte, double, float, half_float, scaled_float
Date
date
Date nanoseconds
date_nanos
Geo-point
geo_point for lat/lon points
Geo-shape
geo_shape for complex shapes like polygons
IP
ip for IPv4 and IPv6 addresses

The ignore_malformed setting value can be updated on existing fields using the PUT mapping API.

Index-level defaultedit

The index.mapping.ignore_malformed setting can be set on the index level to ignore malformed content globally across all allowed mapping types. Mapping types that don’t support the setting will ignore it if set on the index level.

PUT my_index
{
  "settings": {
    "index.mapping.ignore_malformed": true 
  },
  "mappings": {
    "properties": {
      "number_one": { 
        "type": "byte"
      },
      "number_two": {
        "type": "integer",
        "ignore_malformed": false 
      }
    }
  }
}

The number_one field inherits the index-level setting.

The number_two field overrides the index-level setting to turn off ignore_malformed.

Dealing with malformed fieldsedit

Malformed fields are silently ignored at indexing time when ignore_malformed is turned on. Whenever possible it is recommended to keep the number of documents that have a malformed field contained, or queries on this field will become meaningless. Elasticsearch makes it easy to check how many documents have malformed fields by using exists,term or terms queries on the special _ignored field.

Limits for JSON Objectsedit

You can’t use ignore_malformed with the following datatypes:

You also can’t use ignore_malformed to ignore JSON objects submitted to fields of the wrong datatype. A JSON object is any data surrounded by curly brackets "{}" and includes data mapped to the nested, object, and range datatypes.

If you submit a JSON object to an unsupported field, Elasticsearch will return an error and reject the entire document regardless of the ignore_malformed setting.

« ignore_above index »