WARNING: Version 6.2 of Elasticsearch has passed its EOL date.
This documentation is no longer being maintained and may be removed. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.
Span queries
editSpan queries
editSpan queries are low-level positional queries which provide expert control over the order and proximity of the specified terms. These are typically used to implement very specific queries on legal documents or patents.
Span queries cannot be mixed with non-span queries (with the exception of the span_multi
query).
The queries in this group are:
-
span_term
query -
The equivalent of the
term
query but for use with other span queries. -
span_multi
query -
Wraps a
term
,range
,prefix
,wildcard
,regexp
, orfuzzy
query. -
span_first
query - Accepts another span query whose matches must appear within the first N positions of the field.
-
span_near
query - Accepts multiple span queries whose matches must be within the specified distance of each other, and possibly in the same order.
-
span_or
query - Combines multiple span queries — returns documents which match any of the specified queries.
-
span_not
query - Wraps another span query, and excludes any documents which match that query.
-
span_containing
query - Accepts a list of span queries, but only returns those spans which also match a second span query.
-
span_within
query - The result from a single span query is returned as long is its span falls within the spans returned by a list of other span queries.
-
field_masking_span
query -
Allows queries like
span-near
orspan-or
across different fields.