2019-07-17 08:49:22 -04:00
|
|
|
[[request-body-search-from-size]]
|
2019-07-19 14:35:36 -04:00
|
|
|
==== From / Size
|
2013-08-28 19:24:34 -04:00
|
|
|
|
|
|
|
Pagination of results can be done by using the `from` and `size`
|
|
|
|
parameters. The `from` parameter defines the offset from the first
|
|
|
|
result you want to fetch. The `size` parameter allows you to configure
|
|
|
|
the maximum amount of hits to be returned.
|
|
|
|
|
|
|
|
Though `from` and `size` can be set as request parameters, they can also
|
|
|
|
be set within the search body. `from` defaults to `0`, and `size`
|
|
|
|
defaults to `10`.
|
|
|
|
|
2019-09-09 12:35:50 -04:00
|
|
|
[source,console]
|
2013-08-28 19:24:34 -04:00
|
|
|
--------------------------------------------------
|
2016-05-18 05:54:41 -04:00
|
|
|
GET /_search
|
2013-08-28 19:24:34 -04:00
|
|
|
{
|
|
|
|
"from" : 0, "size" : 10,
|
|
|
|
"query" : {
|
|
|
|
"term" : { "user" : "kimchy" }
|
|
|
|
}
|
|
|
|
}
|
|
|
|
--------------------------------------------------
|
2016-05-18 05:54:41 -04:00
|
|
|
|
2015-08-28 14:16:45 -04:00
|
|
|
|
|
|
|
Note that `from` + `size` can not be more than the `index.max_result_window`
|
2019-08-22 21:22:54 -04:00
|
|
|
index setting, which defaults to 10,000.
|
|
|
|
|
|
|
|
WARNING: {es} uses Lucene's internal doc IDs as tie-breakers. These internal
|
|
|
|
doc IDs can be completely different across replicas of the same
|
|
|
|
data. When paginating, you might occasionally see that documents with the same
|
|
|
|
sort values are not ordered consistently. For deep scrolling, it is more
|
|
|
|
efficient to use the <<request-body-search-scroll,Scroll>> or
|
|
|
|
<<request-body-search-search-after,Search After>> APIs.
|