summaryrefslogtreecommitdiff
path: root/docs/reference/query-dsl/queries/span-not-query.asciidoc
diff options
context:
space:
mode:
Diffstat (limited to 'docs/reference/query-dsl/queries/span-not-query.asciidoc')
-rw-r--r--docs/reference/query-dsl/queries/span-not-query.asciidoc24
1 files changed, 24 insertions, 0 deletions
diff --git a/docs/reference/query-dsl/queries/span-not-query.asciidoc b/docs/reference/query-dsl/queries/span-not-query.asciidoc
new file mode 100644
index 0000000..b035720
--- /dev/null
+++ b/docs/reference/query-dsl/queries/span-not-query.asciidoc
@@ -0,0 +1,24 @@
+[[query-dsl-span-not-query]]
+=== Span Not Query
+
+Removes matches which overlap with another span query. The span not
+query maps to Lucene `SpanNotQuery`. Here is an example:
+
+[source,js]
+--------------------------------------------------
+{
+ "span_not" : {
+ "include" : {
+ "span_term" : { "field1" : "value1" }
+ },
+ "exclude" : {
+ "span_term" : { "field2" : "value2" }
+ }
+ }
+}
+--------------------------------------------------
+
+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.