作者：刘晓国
null 不能被索引或搜索。 当字段设置为 null（或空数组或 所有值为 null 值的数组）时，将其视为该字段没有值。使用 null_value 参数可以用指定的值替换显式的空值，以便可以对其进行索引和搜索。
例子一
PUT my-index-000001 { "mappings": { "properties": { "status_code": { "type": "keyword", "null_value": "NULL" } } } }
在上面，我们针对 status_code 字段定义其 null_value，也就是说当我们导入一个文档，当它的 status_code 指定为 null 时，那么在导入时，实际上它是被认为是 status_code 当做 "NULL" 被导入并进行分析。我们以下面的两个文档来进行说明：
PUT my-index-000001/_doc/1 { "status_code": null } PUT my-index-000001/_doc/2 { "status_code": [] }
使用上面的两个命令写入两个文档到索引 my-index-000001 中。我们执行如下的搜索：
GET my-index-000001/_search我们可以搜索到两个文档：
{ "took" : 1, "timed_out" : false, "_shards" : { "total" : 1, "successful" : 1, "skipped" : 0, "failed" : 0 }, "hits" : { "total" : { "value" : 2, "relation" : "eq" }, "max_score" : 1.0, "hits" : [ { "_index" : "my-index-000001", "_type" : "_doc", "_id" : "1", "_score" : 1.0, "_source" : { "status_code" : null } }, { "_index" : "my-index-000001", "_type" : "_doc", "_id" : "2", "_score" : 1.0, "_source" : { "status_code" : [ ] } } ] } }
这显然是正确的，因为我们导入了两个文档。我们接着进行如下的搜索：
GET my-index-000001/_search { "query": { "term": { "status_code": "NULL" } } }
上面的命令显示的结果为：
{ "took" : 1, "timed_out" : false, "_shards" : { "total" : 1, "successful" : 1, "skipped" : 0, "failed" : 0 }, "hits" : { "total" : { "value" : 1, "relation" : "eq" }, "max_score" : 0.2876821, "hits" : [ { "_index" : "my-index-000001", "_type" : "_doc", "_id" : "1", "_score" : 0.2876821, "_source" : { "status_code" : null } } ] } }
显然，第一个文档被搜索到，而第二个文档没有被搜索到。这是因为在第一个文档中，它清楚地指出 "status_code": null，所以在导入文档时，null_value 被认为是 status_code 而被导入并进行分析。第二个文档没有指定它是 null，所以没有被搜索出来。
例子二
假如我们有一下两个文档：
PUT twitter/_doc/1 { "age": null } PUT twitter/_doc/2 { "age": 20 }
在上面，我们有两个文档。第一个文档的 age 值为 null，也就是说它不能被搜索到。假如我们做如下的聚合：
GET twitter/_search { "size": 0, "aggs": { "avg_age": { "avg": { "field": "age" } } } }
那么上面的聚合返回：
{ "took" : 2, "timed_out" : false, "_shards" : { "total" : 1, "successful" : 1, "skipped" : 0, "failed" : 0 }, "hits" : { "total" : { "value" : 2, "relation" : "eq" }, "max_score" : null, "hits" : [ ] }, "aggregations" : { "avg_age" : { "value" : 20.0 } } }
也就是说平均年龄是 20 岁，这是因为第一个文档被视为不见。我们怎么才能让第一个文档也参入聚合呢？我们可以使用 null_value 来为 null 值的字段设置一个值。我们修改 mapping 为：
DELETE twitter PUT twitter { "mappings": { "properties": { "age": { "type": "float", "null_value": 0 } } } }
我们再重新导入之前的两个文档：
PUT twitter/_doc/1 { "age": null } PUT twitter/_doc/2 { "age": 20 }
由于我们已经定义当 age 为 null 时，null_value 将会起作用，它的值将为 0，那么这个文档将为可见。执行如下的聚合：
GET twitter/_search { "size": 0, "aggs": { "avg_age": { "avg": { "field": "age" } } } }
上面的结果为：
{ "took" : 703, "timed_out" : false, "_shards" : { "total" : 1, "successful" : 1, "skipped" : 0, "failed" : 0 }, "hits" : { "total" : { "value" : 2, "relation" : "eq" }, "max_score" : null, "hits" : [ ] }, "aggregations" : { "avg_age" : { "value" : 10.0 } } }
现在的平均值变为 10 了，也就是 （20 + 0)/2 = 10。
这里必须注意的是，我们必须显示地指定 age 为 null，否则 null_vale 将不会起任何的作用。比如：
DELETE twitter PUT twitter { "mappings": { "properties": { "age": { "type": "float", "null_value": 0 } } } } PUT twitter/_doc/1 { "content": "This is cool" } PUT twitter/_doc/2 { "age": 20, "content": "This is cool too!" }
在上面，第一个文档里没有定义 age，那么 null_value 将不会起作用。如果我们做如下的聚合：
GET twitter/_search { "size": 0, "aggs": { "avg_age": { "avg": { "field": "age" } } } }
其显示结果为：
{ "took" : 1, "timed_out" : false, "_shards" : { "total" : 1, "successful" : 1, "skipped" : 0, "failed" : 0 }, "hits" : { "total" : { "value" : 2, "relation" : "eq" }, "max_score" : null, "hits" : [ ] }, "aggregations" : { "avg_age" : { "value" : 20.0 } } }
也就是说第一个文档没有被搜索到。