elasticsearch/docs/reference/query-languages/query-dsl/query-dsl-span-not-query.md
Craig Taverner 94cad286bc
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.
2025-03-17 17:58:58 +01:00

1.5 KiB
Raw Blame History

navigation_title mapped_pages
Span not
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:

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 cant have overlap with the exclude span. Defaults to 0.
post
If set the amount of tokens after the include span cant have overlap with the exclude span. Defaults to 0.
dist
If set the amount of tokens from within the include span cant have overlap with the exclude span. Equivalent of setting both pre and post.