ElasticSearch - 分页查询方式二【scroll】滚动查询（kibana、Java示例）

关注

原创最新推荐文章于 2026-08-04 09:50:22 发布 2.6k 阅读 AI 写同款· GEO 优化 ›

Elasticsearch“滚动查询“（Scrolling）的机制的与Java使用ES Client 调用滚动查询 ES在进行普通的查询时，默认只会查询出来10条数据。我们通过设置es中的size可以将最终的查询结果从10增加到10000。如果需要查询数据量大于es的翻页限制或者需要将es的数据进行导出又当如何？ Elasticsearch提供了一种称为`"滚动查询"（Scrolling）`的机制，用于处理大型数据集的分页查询。滚动查询允许在持续的时间段内保持一个活动的搜索上下文，然后使用滚动ID进行`迭代`检索结果。滚动查询和关系型数据库中的游标有点类似，因此也叫`游标查询` 阅读详情

前言
1、scroll原理

scroll API可用于从单个搜索请求中检索大量结果（甚至所有结果），其方式与在传统数据库上使用光标的方式大致相同。

第一次查询时，会生产当时查询的快照，后续的查询只要携带上次返回的scroll_id即可。
2、特点

可以深查询（甚至全部数据），性能、效率优于from+size方式。
快照查询，在scroll查询期间，外部对索引内的数据进行增删改查等操作不会影响到这个快照的结果。

使用
1、kibana中测试示例

第一次查询，并设置上下文scroll_id存活时间为1分钟。

POST book/_search?scroll=1m
{
   "size": 10,
    "query": {
        "match" : {
            "name": "明朝的那些事"
        }
    }
}

响应：

{
    "_scroll_id":"DXF1ZXJ5QW5kRmV0Y2gBAAAAAAD1K-0WdzM3OF9WRVFUcXk3bFNDcjZKZ1pZdw==",
    "took":22,
    "timed_out":false,
    "_shards":{
        "total":1,
        "successful":1,
        "skipped":0,
        "failed":0
    },
    "hits":{
        "total":1302017,
        "max_score":2.5815613,
        "hits":Array[10]
    }
}

后续查询，使用前一个scroll_id即可：

POST _search/scroll
{
"scroll":"1m",
"scroll_id":"DXF1ZXJ5QW5kRmV0Y2gBAAAAAAD1K-0WdzM3OF9WRVFUcXk3bFNDcjZKZ1pZdw=="

}

2、Java代码示例

首次调用：

// 构建搜索条件
SearchSourceBuilder searchSourceBuilder = new SearchSourceBuilder();
...
searchSourceBuilder.from(100).size(10);
// 构建请求
SearchRequest searchRequest = new SearchRequest("book");
searchRequest.types("title");
// ===》关键是多加了这句话
searchRequest.scroll(new Scroll(TimeValue.timeValueMinutes(1)));
searchRequest.source(searchSourceBuilder);
return client.search(searchRequest, RequestOptions.DEFAULT);

后续调用：

// 传入上次返回的scroll_id
SearchScrollRequest scrollRequest = new SearchScrollRequest(scrollId);
scrollRequest.scroll(TimeValue.timeValueMinutes(1));
SearchResponse response = client.getRestClient().scroll(scrollRequest, RequestOptions.DEFAULT);
return response;

收录于