elasticsearch/docs/reference/query-dsl/span-near-query.asciidoc
Mayya Sharipova d6c53e03d2
Improve span queries documentation (#103490)
Improvement includes:
1. Remove reference to Lucene queries (this information is not necessary
for Elastic users, and can be outdated)
2. For `span_field_masking` include a node to use
"require_field_match" : false parameter for highlighters to work.

Closes #101804
2023-12-19 14:51:19 -05:00

31 lines
848 B
Text

[[query-dsl-span-near-query]]
=== Span near query
++++
<titleabbrev>Span near</titleabbrev>
++++
Matches spans which are near one another. One can specify _slop_, the
maximum number of intervening unmatched positions, as well as whether
matches are required to be in-order. Here is an example:
[source,console]
--------------------------------------------------
GET /_search
{
"query": {
"span_near": {
"clauses": [
{ "span_term": { "field": "value1" } },
{ "span_term": { "field": "value2" } },
{ "span_term": { "field": "value3" } }
],
"slop": 12,
"in_order": false
}
}
}
--------------------------------------------------
The `clauses` element is a list of one or more other span type queries
and the `slop` controls the maximum number of intervening unmatched
positions permitted.