mirror of
https://github.com/elastic/elasticsearch.git
synced 2025-06-30 10:23:41 -04:00
a8b2428dd1
* Restructure query-languages docs files for clarity (#124797) In a few previous PR's we restructured the ES|QL docs to make it possible to generate them dynamically. This PR just moves a few files around to make the query languages docs easier to work with, and a little more organized like the ES|QL docs. A bit part of this was setting up redirects to the new locations, so other repo's could correctly link to the elasticsearch docs. * After running tests, we revert a few features * Fix build.gradle and improved some generating code * After running tests * Update x-pack/plugin/esql/build.gradle
49 lines
1.5 KiB
Markdown
49 lines
1.5 KiB
Markdown
---
|
||
navigation_title: "Span not"
|
||
mapped_pages:
|
||
- https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-span-not-query.html
|
||
---
|
||
|
||
# Span not query [query-dsl-span-not-query]
|
||
|
||
|
||
Removes matches which overlap with another span query or which are within x tokens before (controlled by the parameter `pre`) or y tokens after (controlled by the parameter `post`) another SpanQuery. Here is an example:
|
||
|
||
```console
|
||
GET /_search
|
||
{
|
||
"query": {
|
||
"span_not": {
|
||
"include": {
|
||
"span_term": { "field1": "hoya" }
|
||
},
|
||
"exclude": {
|
||
"span_near": {
|
||
"clauses": [
|
||
{ "span_term": { "field1": "la" } },
|
||
{ "span_term": { "field1": "hoya" } }
|
||
],
|
||
"slop": 0,
|
||
"in_order": true
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
The `include` and `exclude` clauses can be any span type query. The `include` clause is the span query whose matches are filtered, and the `exclude` clause is the span query whose matches must not overlap those returned.
|
||
|
||
In the above example all documents with the term hoya are filtered except the ones that have *la* preceding them.
|
||
|
||
Other top level options:
|
||
|
||
`pre`
|
||
: If set the amount of tokens before the include span can’t have overlap with the exclude span. Defaults to 0.
|
||
|
||
`post`
|
||
: If set the amount of tokens after the include span can’t have overlap with the exclude span. Defaults to 0.
|
||
|
||
`dist`
|
||
: If set the amount of tokens from within the include span can’t have overlap with the exclude span. Equivalent of setting both `pre` and `post`.
|
||
|