Skip to content

Commit

Permalink
Update bucket.asciidoc (#73306)
Browse files Browse the repository at this point in the history
Explains the discrepancy in behavior between bucket aggregation and composite 
aggregations in handling -1 in `search.max_buckets` settings.
  • Loading branch information
nephel authored May 26, 2021
1 parent bb580a4 commit 4c5f2e4
Showing 1 changed file with 4 additions and 1 deletion.
5 changes: 4 additions & 1 deletion docs/reference/aggregations/bucket.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,10 @@ define fixed number of multiple buckets, and others dynamically create the bucke

NOTE: The maximum number of buckets allowed in a single response is limited by a dynamic cluster
setting named `search.max_buckets`. It is disabled by default (-1) but requests that try to return more than
10,000 buckets (the default value for future versions) will log a deprecation warning.
10,000 buckets (the default value for future versions) will log a deprecation warning.
When using composite aggs however, the handling of -1 differs. Elasticsearch would use the soft limit as a
hard limit for those aggregations, and raise a `TooManyBucketsException`
about `Trying to create too many buckets. Must be less than or equal to: [10000]` if the soft limit is exceeded.

include::bucket/adjacency-matrix-aggregation.asciidoc[]

Expand Down

0 comments on commit 4c5f2e4

Please sign in to comment.