mirror of
https://github.com/elastic/elasticsearch.git
synced 2025-04-25 23:57:20 -04:00
a7ca62de8e
This adds some docs to the top of `docs.csv-spec` and `docs-IT_tests_only.csv-spec` telling folks not to add more stuff there and instead put new examples into whatever files they line up with. It also shifts some things out of the file to "prime the pump" on cleaning it up.
47 lines
1.1 KiB
Text
47 lines
1.1 KiB
Text
[discrete]
|
|
[[esql-limit]]
|
|
=== `LIMIT`
|
|
|
|
**Syntax**
|
|
|
|
[source,esql]
|
|
----
|
|
LIMIT max_number_of_rows
|
|
----
|
|
|
|
*Parameters*
|
|
|
|
`max_number_of_rows`::
|
|
The maximum number of rows to return.
|
|
|
|
*Description*
|
|
|
|
The `LIMIT` processing command enables you to limit the number of rows that are
|
|
returned.
|
|
// tag::limitation[]
|
|
Queries do not return more than 10,000 rows, regardless of the `LIMIT` command's
|
|
value.
|
|
|
|
This limit only applies to the number of rows that are retrieved by the query.
|
|
Queries and aggregations run on the full data set.
|
|
|
|
To overcome this limitation:
|
|
|
|
* Reduce the result set size by modifying the query to only return relevant
|
|
data. Use <<esql-where>> to select a smaller subset of the data.
|
|
* Shift any post-query processing to the query itself. You can use the {esql}
|
|
<<esql-stats-by>> command to aggregate data in the query.
|
|
|
|
The default and maximum limits can be changed using these dynamic cluster
|
|
settings:
|
|
|
|
* `esql.query.result_truncation_default_size`
|
|
* `esql.query.result_truncation_max_size`
|
|
// end::limitation[]
|
|
|
|
*Example*
|
|
|
|
[source,esql]
|
|
----
|
|
include::{esql-specs}/limit.csv-spec[tag=basic]
|
|
----
|