elasticsearch/docs/reference/query-languages/query-dsl-span-not-query.md
Colleen McGinnis b7e3a1e14b
[docs] Migrate docs from AsciiDoc to Markdown (#123507)
* delete asciidoc files

* add migrated files

* fix errors

* Disable docs tests

* Clarify release notes page titles

* Revert "Clarify release notes page titles"

This reverts commit 8be688648d.

* Comment out edternal URI images

* Clean up query languages landing pages, link to conceptual docs

* Add .md to url

* Fixes inference processor nesting.

---------

Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com>
Co-authored-by: Liam Thompson <leemthompo@gmail.com>
Co-authored-by: Martijn Laarman <Mpdreamz@gmail.com>
Co-authored-by: István Zoltán Szabó <szabosteve@gmail.com>
2025-02-27 17:56:14 +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.