es java api 获取总数_ES系列之原来查看文档数量有这么多姿势

1、引言

有人可能觉得，查看文档数量不是很简单吗？直接

GET /_cat/count/index_name?v

不就可以了吗。

事实上远不止这么简单，比如嵌套文档的情况等。相信你看了我这篇文章之后你会感叹原来统计文档有这么多讲究啊。

2、正文

cat/count

首先是最常用的的方式，也是一种快速查询文档的优先推荐方式，cat count api我们使用kibana自带的电商索引来实验。

GET _cat/count/kibana_sample_data_ecommerce?v

返回，

epoch timestamp count

1585910697 10:44:57 4675

cat count api的方式能够快速的返回某个索引下文档的数量，需要注意的是已经删除的文档即使还没有物理删除(merge)也不会统计。我们可以来做个实验，任意删除一个文档，然后再次查询下。

DELETE kibana_sample_data_ecommerce/_doc/VJz1f28BdseAsPClo7bC

再次查询发现少了一条。

另外，使用cat count api我们也可以不指定索引，从而查询整个集群的文档数量。

GET _cat/count?v

GET _cat/indices

整个命令其实主要是用来查询索引相关的信息的，而这些信息里面包含文档的数量。 比如，

GET _cat/indices/kibana_sample_data_ecommerce?v

查询的结果如下，

docs.count列就是文档的数量。

和cat count api不同的是，cat indices命令统计的文档数量是底层所有的文档数量，如果你不太明天，我举个例子。

我们新增一个测试的索引，使用nested嵌套文档，关于嵌套文档可以看看这篇文章，这里不详述了。

新建一个索引，然后插入一个文档。

PUT my_index

{

"mappings": {

"properties": {

"user": {

"type": "nested"

}

}

}

}

PUT my_index/_doc/1

{

"group" : "fans",

"user" : [

{

"first" : "John",

"last" : "Smith"

},

{

"first" : "Alice",

"last" : "White"

}

]

}

我们先用cat count api查询下，结果是1，然后用cat indices查询，发现结果是3。这是为什么呢？

这是因为cat indices是直接从lucene获取的这些信息，而我们之前的文章讲过nested类型的属性其实在lucene内部是独立的文档，只不过在ES这一层隐藏了这些细节。

使用search api

我们当然可以直接使用search去统计文档数量，只要不指定查询条件，然后查询结果中的total就是文档的总数量。

GET kibana_sample_data_ecommerce/_search

{

"query": {

"match_all": {}

}

}

结果是(只显示部分)，

"hits" : {

"total" : {

"value" : 4673,

"relation" : "eq"

},

"max_score" : 1.0,

"hits" : [

{

不过search api有个问题，这个total最大只会显示10000个，这个我就不举例子了。

这里我们可以进一步探讨一个问题，cat count api和search方式统计文档哪个效率高？我没有找到官方文档，不过大概也能推断出前者应该是更快一些，因为查询还要算分，排名这些操作，应该更耗时。

利用聚合统计文档

我们还可以利用ES的聚合函数统计文档数量，如下：

GET /kibana_sample_data_ecommerce/_search

{

"size" : 0,

"aggs" : {

"my_count" : {

"value_count": {

"field" : "_id"

}

}

}

}

结果是，

{

"took" : 24,

"timed_out" : false,

"_shards" : {

"total" : 1,

"successful" : 1,

"skipped" : 0,

"failed" : 0

},

"hits" : {

"total" : {

"value" : 4672,

"relation" : "eq"

},

"max_score" : null,

"hits" : [ ]

},

"aggregations" : {

"my_count" : {

"value" : 4672

}

}

}

我们这里用了Value Count Aggregation 按字段统计文档数量。

查看分片上的文档数量

有时候我们需要查看一个分片上文档数量，使用cat shards api可以做到。

GET _cat/shards/kibana_sample_data_ecommerce?v

可以看到这个索引下有两个分片，一个主分片一个副本分片，docs列显示的是文档数量。

3、总结

ES对文档的统计根据不同的场景和维度，有不同的方法，在实际项目中根据业务场景选择适合自己的方式即可。