Scroll
search
请求返回一个单一的结果“页”,而 scroll
滚动并不是为了实时的用户响应,而是为了处理大量的数据,例如,为了使用不同的配置来重新索引一个 index 到另一个 index 中去。
client 支持:Perl 和 Python
注意:从 scroll 请求返回的结果反映了 search
scroll
参数,这可以告诉 Elasticsearch 需要保持搜索的上下文环境多久(参考Keeping the search context alive),如 ?scroll=1m
。
curl -XGET 'localhost:9200/twitter/tweet/_search?scroll=1m' -d '
{
"query": {
"match" : {
"title" : "elasticsearch"
}
}
}
'
scroll_id
,这个 ID 可以被传递给 scroll
curl -XGET 'localhost:9200/_search/scroll' -d'
{
"scroll" : "1m",
"scroll_id" : "c2Nhbjs2OzM0NDg1ODpzRlBLc0FXNlNyNm5JWUc1"
}
'
GET
- 或者
POST
- URL不应该包含
index
- 或者
type
- 名字——这些都指定在了原始的
search
scroll
- 参数告诉 Elasticsearch 保持搜索的上下文等待另一个
1m
scroll_id
scroll
API 的调用返回了结果的下一个批次知道没有更多的结果返回,也就是直到 hits
scroll_id
和 scroll
可以放在查询字符串中传递。scroll_id
curl -XGET 'localhost:9200/_search/scroll?scroll=1m' -d 'c2Nhbjs2OzM0NDg1ODpzRlBLc0FXNlNyNm5JWUc1'
_scroll_id——只有最近的 _scroll_id
如果请求指定了聚合(aggregation),仅仅初始搜索响应才会包含聚合结果。
使用 scroll-scan 的高效滚动
from and size
的深度分页,比如说 ?size=10&from=10000
是非常低效的,因为 100,000
排序的结果必须从每个分片上取出并重新排序最后返回 10
scroll
scroll
和 scan
来关闭任何打分或者排序,以最高效的方式返回结果。你需要做的就是将 search_type=scan
curl -XGET 'localhost:9200/twitter/tweet/_search?scroll=1m&search_type=scan' -d '
{
"query": {
"match" : {
"title" : "elasticsearch"
}
}
}
'
- 设置
search_type
- 为
scan
扫描式的滚动请求和标准的滚动请求有四处不同:
- 不算分,关闭排序。结果会按照在索引中出现的顺序返回。
- 不支持聚合
- 初始
search
- 请求的响应不会在
hits
- 数组中包含任何结果。第一批结果就会按照第一个
scroll
- 参数
size
- 控制了每个分片上而非每个请求的结果数目,所以
size
- 为
10
track_scores
设置为 true
。
保持搜索上下文存活
scroll
(传递给 search
请求还有每个 scroll
请求)告诉 Elasticsearch 应该需要保持搜索上下文多久。这个值(比如说 1m
,详情请见the section called “Time units)并不需要长到可以处理所有的数据——仅仅需要足够长来处理前一批次的结果。每个 scroll
请求(包含 scroll
一般来说,背后的合并过程通过合并更小的分段创建更大的分段来优化索引,同时会删除更小的分段。这个过程在滚动时进行,但是一个打开状态的搜索上下文阻止了旧分段在使用的时候不会被删除。这就是 Elasticsearch 能够不管后续的文档的变化,返回初始搜索请求的结果的原因。
保持旧的分段存活意味着会产生更多的文件句柄。确保你配置了节点有空闲的文件句柄。参考File Descriptors
你可以检查有多少搜索上下文开启了,
curl -XGET localhost:9200/_nodes/stats/indices/search?pretty
清除 scroll API
scroll
超时就会自动移除。但是保持 scroll 存活需要代价,如在前一节讲的那样,所以 scrolls 当scroll不再被使用的时候需要被用 clear-scroll
curl -XDELETE localhost:9200/_search/scroll -d '
{
"scroll_id" : ["c2Nhbjs2OzM0NDg1ODpzRlBLc0FXNlNyNm5JWUc1"]
}'
2.0.0-beta1 中加入。基于请求体的参数在 2.0.0 中加入。
多个 scroll ID 可按照数据传入:
curl -XDELETE localhost:9200/_search/scroll -d '
{
"scroll_id" : ["c2Nhbjs2OzM0NDg1ODpzRlBLc0FXNlNyNm5JWUc1", "aGVuRmV0Y2g7NTsxOnkxaDZ"]
}'
2.0.0 中加入。
_all
curl -XDELETE localhost:9200/_search/scroll/_all
scroll_id
curl -XDELETE localhost:9200/_search/scroll \ -d 'c2Nhbjs2OzM0NDg1ODpzRlBLc0FXNlNyNm5JWUc1,aGVuRmV0Y2g7NTsxOnkxaDZ'