diff --git a/docs/Aggregation/Children.md b/docs/Aggregation/Children.md new file mode 100644 index 0000000000000000000000000000000000000000..4358561d4ca8569a78e081c4bd0ce9e127ca8513 --- /dev/null +++ b/docs/Aggregation/Children.md @@ -0,0 +1,43 @@ +# Children Aggregation + +> More info about children aggregation is in the [official elasticsearch docs][1] + +A special single bucket aggregation that enables aggregating from buckets on parent +document types to buckets on child documents. + +## Simple example + +```JSON +{ + "aggregations": { + "agg_author_count": { + "children": { + "type": "answer" + }, + "aggregations": { + "agg_top_names": { + "terms": { + "field": "owner.display_name" + } + } + } + } + } +} +``` + +And now the query via DSL: + +```php +$termsAggregation = new TermsAggregation('top_names', 'owner.display_name'); + +$childrenAggregation = new ChildrenAggregation('author_count', 'answer'); +$childrenAggregation->addAggregation($termsAggregation); + +$search = new Search(); +$search->addAggregation($childrenAggregation); + +$queryArray = $search->toArray(); +``` + +[1]: https://www.elastic.co/guide/en/elasticsearch/reference/current/search-aggregations-bucket-children-aggregation.html