Skip to content

Commit 4c5f2e4

Browse files
authored
Update bucket.asciidoc (#73306)
Explains the discrepancy in behavior between bucket aggregation and composite aggregations in handling -1 in `search.max_buckets` settings.
1 parent bb580a4 commit 4c5f2e4

File tree

1 file changed

+4
-1
lines changed

1 file changed

+4
-1
lines changed

docs/reference/aggregations/bucket.asciidoc

+4-1
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,10 @@ define fixed number of multiple buckets, and others dynamically create the bucke
1515

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

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

0 commit comments

Comments
 (0)