Adding a warning to from-size.asciidoc

Customers occasionally discover a known behavior in Elasticsearch's pagination that does not appear to be documented. This warning is intended to educate customers of this behavior while still highlighting alternative solutions.
This commit is contained in:
Nathan Howard 2019-08-22 18:22:54 -07:00 committed by Deb Adair
parent 0d208dedf6
commit bdfd90560f
1 changed files with 8 additions and 2 deletions

View File

@ -24,5 +24,11 @@ GET /_search
Note that `from` + `size` can not be more than the `index.max_result_window`
index setting which defaults to 10,000. See the <<request-body-search-scroll,Scroll>> or <<request-body-search-search-after,Search After>>
API for more efficient ways to do deep scrolling.
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.