honeymoose
/
OpenSearch
mirror of https://github.com/honeymoose/OpenSearch.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

[DOCS] Fix deep paging recommendations 

Corrects recommendation to reference the `search_after` parameter,
not API.

Also corrects a typo and whitespace inconsistencies in the search docs.
This commit is contained in:
James Rodewig 2020-06-01 18:01:46 -04:00
parent a1514c9ffe
commit 6592c3856d
3 changed files with 16 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
docs/reference/search/index.asciidoc
View File

@ -17,7 +17,7 @@ Depending on your data, you can use a query to get answers to questions like:
* How many of my products have a price greater than $20? * How many of my products have a price greater than $20?
A _search_ consists of one or more queries that are combined and sent to {es}. A _search_ consists of one or more queries that are combined and sent to {es}.
Documents that match the a search's queries are returned in the _hits_, or Documents that match a search's queries are returned in the _hits_, or
_search results_, of the response. _search results_, of the response.
A search may also contain additional information used to better process its A search may also contain additional information used to better process its

6
docs/reference/search/request/from-size.asciidoc
View File

@ -41,9 +41,9 @@ multiple shards, each shard must generate its own sorted results. These separate
results must then be combined and sorted to ensure that the overall sort order results must then be combined and sorted to ensure that the overall sort order
is correct. is correct.
As an alternative to deep paging, we recommend using the As an alternative to deep paging, we recommend using
<<request-body-search-scroll,Scroll>> or <<request-body-search-scroll,scroll>> or the
<<request-body-search-search-after,Search After>> APIs. <<request-body-search-search-after,`search_after`>> parameter.
WARNING: {es} uses Lucene's internal doc IDs as tie-breakers. These internal WARNING: {es} uses Lucene's internal doc IDs as tie-breakers. These internal
doc IDs can be completely different across replicas of the same doc IDs can be completely different across replicas of the same

26
docs/reference/search/search.asciidoc
View File

@ -12,7 +12,6 @@ GET /twitter/_search
---- ----
// TEST[setup:twitter] // TEST[setup:twitter]
[[search-search-api-request]] [[search-search-api-request]]
==== {api-request-title} ==== {api-request-title}
@ -24,7 +23,6 @@ GET /twitter/_search
`POST /_search` `POST /_search`
[[search-search-api-desc]] [[search-search-api-desc]]
==== {api-description-title} ==== {api-description-title}
@ -99,9 +97,9 @@ multiple shards, each shard must generate its own sorted results. These separate
results must then be combined and sorted to ensure that the overall order is results must then be combined and sorted to ensure that the overall order is
correct. correct.
As an alternative to deep paging, we recommend using the As an alternative to deep paging, we recommend using
<<request-body-search-scroll,Scroll>> or <<request-body-search-scroll,scroll>> or the
<<request-body-search-search-after,Search After>> APIs. <<request-body-search-search-after,`search_after`>> parameter.
[IMPORTANT] [IMPORTANT]
==== ====
@ -196,9 +194,9 @@ multiple shards, each shard must generate its own sorted results. These separate
results must then be combined and sorted to ensure that the overall order is results must then be combined and sorted to ensure that the overall order is
correct. correct.
As an alternative to deep paging, we recommend using the As an alternative to deep paging, we recommend using
<<request-body-search-scroll,Scroll>> or <<request-body-search-scroll,scroll>> or the
<<request-body-search-search-after,Search After>> APIs. <<request-body-search-search-after,`search_after`>> parameter.
[IMPORTANT] [IMPORTANT]
==== ====
@ -319,9 +317,9 @@ multiple shards, each shard must generate its own sorted results. These separate
results must then be combined and sorted to ensure that the overall order is results must then be combined and sorted to ensure that the overall order is
correct. correct.
As an alternative to deep paging, we recommend using the As an alternative to deep paging, we recommend using
<<request-body-search-scroll,Scroll>> or <<request-body-search-scroll,scroll>> or the
<<request-body-search-search-after,Search After>> APIs. <<request-body-search-search-after,`search_after`>> parameter.
[IMPORTANT] [IMPORTANT]
==== ====
@ -363,9 +361,9 @@ multiple shards, each shard must generate its own sorted results. These separate
results must then be combined and sorted to ensure that the overall order is results must then be combined and sorted to ensure that the overall order is
correct. correct.
As an alternative to deep paging, we recommend using the As an alternative to deep paging, we recommend using
<<request-body-search-scroll,Scroll>> or <<request-body-search-scroll,scroll>> or the
<<request-body-search-search-after,Search After>> APIs. <<request-body-search-search-after,`search_after`>> parameter.
[IMPORTANT] [IMPORTANT]
==== ====