Browse Source

[DOCS] Document limits for JSON objects with `ignore_malformed` mapping setting (#40976)

James Rodewig 6 years ago
parent
commit
5a44cab87f
1 changed files with 13 additions and 0 deletions
  1. 13 0
      docs/reference/mapping/params/ignore-malformed.asciidoc

+ 13 - 0
docs/reference/mapping/params/ignore-malformed.asciidoc

@@ -91,3 +91,16 @@ become meaningless. Elasticsearch makes it easy to check how many documents
 have malformed fields by using `exist` or `term` queries on the special
 <<mapping-ignored-field,`_ignored`>> field.
 
+==== Limits for JSON Objects
+You can't use `ignore_malformed` with the following datatypes:
+
+* <<nested, Nested datatype>>
+* <<object, Object datatype>>
+* <<range, Range 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, {es} will return an error
+and reject the entire document regardless of the `ignore_malformed` setting.