mirror of
https://github.com/elastic/elasticsearch.git
synced 2025-04-25 15:47:23 -04:00
1256a49c3a
This copies the first line of the description of each command to just under the syntax so that it's "in order", before the `Parameters` section. That way if you are reading from top to bottom you see: ``` syntax short description parameter names and descriptions long description examples ``` I've also removed the `Description` section entirely if the description was just one sentence. So in some cases that just isn't `long description`.
50 lines
1.2 KiB
Text
50 lines
1.2 KiB
Text
[discrete]
|
|
[[esql-limit]]
|
|
=== `LIMIT`
|
|
|
|
The `LIMIT` processing command enables you to limit the number of rows that are
|
|
returned.
|
|
|
|
**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]
|
|
----
|