summaryrefslogtreecommitdiff
path: root/docs/reference/query-dsl/filters/missing-filter.asciidoc
blob: 70685bd128cd987ec9f73f0460ab3067e33bc57c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
[[query-dsl-missing-filter]]
=== Missing Filter

Filters documents where a specific field has no value in them.

[source,js]
--------------------------------------------------
{
    "constant_score" : {
        "filter" : {
            "missing" : { "field" : "user" }
        }
    }
}
--------------------------------------------------

By default, the filter will only find "missing" fields, i.e., fields
that have no values. It can be configured also to find fields with an
explicit `null_value` mapped for them. Here is an example that will both
find missing field that don't exists (`existence` set to `true`), or
have null values (`null_value` set to `true`).

[source,js]
--------------------------------------------------
{
    "constant_score" : {
        "filter" : {
            "missing" : { 
                "field" : "user",
                "existence" : true,
                "null_value" : true
            }
        }
    }
}
--------------------------------------------------

[float]
==== Caching

The result of the filter is always cached.