目录
一. 问题描述
开发环境: JDK1.8、Elasticsearch7.3.1、RestHighLevelClient
问题: 最近在通过Java客户端操作ES进行分页查询(from+size)时,需要返回满足条件的数据总数。我发现满足条件的数据总数一旦超过10000条,使用SearchResponse的getHits().getTotalHits().value返回的结果永远是10000。为什么会被限制只能搜索10000条数据呢?如何查询精确的数据总数呢?
Tips: 本文侧重点在如何精确的获取数据总数,如果想知道如何深度搜索,请参考我的另一篇博客 Elasticsearch from+size与scroll混合使用实现深度分页搜索
二. 问题分析
查看官方文档: Elasticsearch 7.3
Elasicsearch通过index.max_result_window参数控制了能够获取的数据总数from+size的最大值,默认是10000条。但是,由于数据需要从其它节点分别上报到协调节点,因此搜索请求的数据越多,会导致在协调节点占用分配给Elasticsearch的堆内存和搜索、排序时间越大。针对这种满足条件数量较多的深度搜索,官方建议我们使用Scroll。
三. 解决方案
3.1 调大index.max_result_window(不推荐)
既然知道了是index.max_result_window参数限制了搜索数量,我们可以通过适当调高index.max_result_window的值,以此来满足需求。设置方法如下:
- kibana上执行
新建索引:
PUT your_index
{
"settings": {
"max_result_window": "100000"
}
}
在原有索引的基础上,调大index.max_result_window的默认值:
PUT your_index/_settings?preserve_existing=true
{
"max_result_window": "100000"
}
- 服务器上执行
curl -H "Content-Type: application/json" -X PUT 'http://127.0.0.1:9200/your_index/_settings?preserve_existing=true' -d '{"max_result_window" : "100000"}'
这个方案我个人不太推荐,除非能预估出生产环境中索引内数据总量可能达到的上限,否则在未来实际数据量可能会超过设置的值,仍然会再次引发搜索数量受限的问题。
3.2 cardinality(不推荐)
cardinality字面意思是基数,作为聚合函数,它的作用与Mysql中的distinct类似,用于统计给定字段的不同值的数量。值得注意的是,cardinality获取的仅仅是估计值。使用方式如下:
SearchSourceBuilder sourceBuilder = new SearchSourceBuilder();
// 设置聚合函数
AggregationBuilder aggregationBuilder = AggregationBuilders.cardinality("distinct_id").field("_id");
sourceBuilder.aggregation(aggregationBuilder);
// 调用ES客户端,发起请求,得到响应结果
response = search("INDEX_NAME索引名称", sourceBuilder);
// 获取总记录数
total = ((ParsedCardinality)response.getAggregations().getAsMap().get("distinct_id")).getValue();
其中,“distinct_id"是我为聚合函数随便起的名称,可以任意指定,”_id"是希望进行分组统计的字段名称。上方这一段代码实际上可以翻译成以下执行语句:
GET index_name/_search
{
"aggs": {
"distinct_id": {
"cardinality": {
"field": "_id"
}
}
}
}
3.3 track_total_hits(推荐)
文档: track_total_hits
使用方式:
SearchSourceBuilder sourceBuilder = new SearchSourceBuilder();
sourceBuilder.trackTotalHits(true);
// 省略查询方法...
SearchResponse sumResponse = search(sourceBuilder);
if(sumResponse != null) {
// 满足条件的总记录数
long total = sumResponse.getHits().getTotalHits().value;
}
Elasticsearch from+size与scroll混合使用实现深度分页搜索
一. 需求
环境准备: JDK1.8 Elasticsearch7.3.1 RestHighLevelClient客户端
对Elasticsearch做深度分页,比如第1500页,每页20条记录,且需要支持前后翻页。
二. 思考
由于index.max_result_window的限制,直接使用from+size无法搜索满足条件10000条以上的记录。如果贸然增大index.max_result_window值,那么你怎么知道系统未来会在索引内存多少条数据?
就算这一次设置值暂时解决了问题,那么未来又陷入瓶颈了怎么办?重新设值吗?调大后会增大内存压力的问题难道就不需要考虑吗?
这时就需要使用scroll了,但scroll不能盲目的使用,它虽然支持深度分页,纯粹的使用scroll只能不断地向后翻页,我们还需要考虑如何向前翻页。
三. 实现方案
不改变index.max_result_window的默认值,但搜索手段根据搜索数量划分为以下两种:
- 搜索数量<=10000
使用from+size的方式分页和搜索数据。 - 搜索数量>10000
使用scroll的方式搜索数据。针对对每次分页查询请求,我都会创建游标,接着手动滚动到包含请求数据的那一屏,最后取出请求页面中的目标数据。
比如现在准备查询第1413页,页面容量为10条数据,游标每次移动1000条记录,总记录数为1000000(这个值不重要了)。如果以1作为第一条数据的下标,则有以下规律:
滚屏次数 | 数据的下标范围 |
---|---|
1 | 1~1000 |
2 | 1001~2000 |
… | … |
15 | 14001 ~ 15000 |
n | (n-1) * 1000 + 1 ~ n*1000 |
第1413页的第一条数据的下标=(1413-1)*10+1=14121
第1413页的最后一条数据的下标=14121+10-1=14130
只需要移动15次游标,则在第15次游标查询返回的1000条数据中,一定包含了第1413页的所有数据。
但我们还需要考虑另一种情况,比如现在准备查询第934页,页面容量为15条数据,游标仍然保持每次移动1000条记录。
第934页的第一条数据的下标=(934-1)*15+1=13996
第934页的最后一条数据的下标=13996+15-1=14010
注意,我们的游标只能获取13001~14000和14001~15000范围内的数据,第934页会横跨两次游标执行结果,针对这种情况,我在代码中做了特殊处理。
接下来是代码:
- 定义搜索条件
// 自定义搜索条件
BoolQueryBuilder boolQueryBuilder = QueryBuilders.boolQuery();
boolQueryBuilder.must(QueryBuilders.matchQuery("name", "麦当劳"));
SearchSourceBuilder sourceBuilder = new SearchSourceBuilder();
sourceBuilder.query(boolQueryBuilder);
// 设置请求超时时间
sourceBuilder.timeout(new TimeValue(20, TimeUnit.SECONDS));
// 排序
sourceBuilder.sort("salary", SortOrder.ASC);
- 与ES客户端交互的底层逻辑
esClient就是RestHighLevelClient的对象
protected SearchResponse search(String requestIndexName, SearchSourceBuilder sourceBuilder) throws Exception {
SearchRequest searchRequest = new SearchRequest(requestIndexName);
searchRequest.source(sourceBuilder);
return esClient.search(searchRequest, RequestOptions.DEFAULT);
}
protected SearchResponse search(String requestIndexName,SearchSourceBuilder searchSourceBuilder,
TimeValue timeValue) throws IOException {
SearchRequest searchRequest = new SearchRequest(requestIndexName);
searchSourceBuilder.size(ElasticsearchConstant.MAX_SCROLL_NUM);
searchRequest.source(searchSourceBuilder);
searchRequest.scroll(timeValue);
return esClient.search(searchRequest, RequestOptions.DEFAULT);
}
protected SearchResponse searchScroll(String scrollId, TimeValue timeValue) throws IOException {
SearchScrollRequest searchScrollRequest = new SearchScrollRequest(scrollId);
searchScrollRequest.scroll(timeValue);
return esClient.scroll(searchScrollRequest, RequestOptions.DEFAULT);
}
- 搜索逻辑(核心代码)
// 本次搜索满足条件的数据总数
long total = 0;
// 精度
int accuracy = 1;
// 希望被忽略的记录条数
int ignoreLogNum = (pageNum - 1) * pageSize;
// 待查询页面内第一条记录的下标
int firstSelectLogNum = 1;
// 待查询页面内最后一条记录的下标
int lastSelectLogNum = -1;
// 当前游标查询返回结果中最后一条记录的下标
int lastAllowLogNum = -1;
// 游标Id
String scrollId = null;
// Elasticsearch 搜索返回结果对象
SearchResponse response = null;
try {
firstSelectLogNum = ignoreLogNum + 1;
lastSelectLogNum = firstSelectLogNum + pageSize - 1;
String indexName = ElasticsearchConstant.SUB_INDEX_NAME_PREFIX + bizSubLogQuery.getProductNum().toLowerCase();
if(firstSelectLogNum > ElasticsearchConstant.MAX_RESULT_WINDOW) {
// 构建游标查询 此时游标已经移动了1次
response = search(indexName, sourceBuilder, TimeValue.timeValueMinutes(1));
if(response != null && response.getHits().getHits().length > 0) {
// 游标总共需要移动的次数
int scrollNum = firstSelectLogNum / ElasticsearchConstant.MAX_SCROLL_NUM + 1;
lastAllowLogNum = scrollNum * ElasticsearchConstant.MAX_SCROLL_NUM;
accuracy = firstSelectLogNum - (firstSelectLogNum / ElasticsearchConstant.MAX_SCROLL_NUM) * ElasticsearchConstant.MAX_SCROLL_NUM;
// 游标Id
scrollId = response.getScrollId();
// 游标还需移动scrollNum-1次
while(--scrollNum > 0 && scrollId != null) {
response = searchScroll(scrollId, TimeValue.timeValueMinutes(1));
scrollId = response.getScrollId();
}
}
} else {
// 分页参数
sourceBuilder.from((pageNum - 1) * pageSize);
sourceBuilder.size(pageSize);
// 获取满足记录的总条数
response = search(indexName, sourceBuilder);
}
// 查询总数
sourceBuilder.size(0);
sourceBuilder.trackTotalHits(true);
SearchResponse sumResponse = search(indexName, sourceBuilder);
if(sumResponse != null) {
total = sumResponse.getHits().getTotalHits().value;
}
} catch (ElasticsearchStatusException ese) {
if (RestStatus.NOT_FOUND == ese.status()) {
log.error("待搜索的产品不存在");
} else {
log