Structural parameters #
properties
#
Nested sub-fields, for object-shaped types.
fields
#
It is often useful to index the same field in different ways for different purposes. This is the purpose of multi-fields.
A dense_vector sub-field gets a derived meaning — semantic wiring:
declare it with vector_options.model + dims on a top-level
text/keyword field and the parent’s text is embedded server-side at
write time (the source is implicitly the parent and must not be set
explicitly; the model must resolve to a configured embedding endpoint).
See
the declarative
form.
Carried by:
text,
keyword,
numeric and boolean types,
date,
dense_vector (semantic
multi-field).
nested
#
Object fields only — set "nested": true to index sub-fields with
per-inner-object ordinals (positive/negative examples under the
nested type). The wire alias
"type": "nested" implies nested: true and readbacks as that form;
{"type": "nested", "nested": false} opts out to a plain object. Setting
the parameter on any non-object type is rejected with
mapper_parsing_exception (“unknown parameter [nested]”), matching
Elasticsearch: per-element correlation is a property of an object
container (which sub-fields correlate?), never of a scalar field.