Package org.elasticsearch.search.aggregations.support

Class AggregationPath

java.lang.Object
org.elasticsearch.search.aggregations.support.AggregationPath
public class AggregationPath extends Object
A path that can be used to sort/order buckets (in some multi-bucket aggregations, e.g. terms & histogram) based on sub-aggregations. The path may point to either a single-bucket aggregation or a metrics aggregation. If the path points to a single-bucket aggregation, the sort will be applied based on the doc_count of the bucket. If this path points to a metrics aggregation, if it's a single-value metrics (eg. avg, max, min, etc..) the sort will be applied on that single value. If it points to a multi-value metrics, the path should point out what metric should be the sort-by value.

The path has the following form: <aggregation_name>['>'<aggregation_name>*]['.'<metric_name>]

Examples:

  • agg1>agg2>agg3 - where agg1, agg2 and agg3 are all single-bucket aggs (eg filter, nested, missing, etc..). In this case, the order will be based on the number of documents under agg3.
  • agg1>agg2>agg3 - where agg1 and agg2 are both single-bucket aggs and agg3 is a single-value metrics agg (eg avg, max, min, etc..). In this case, the order will be based on the value of agg3.
  • agg1>agg2>agg3.avg - where agg1 and agg2 are both single-bucket aggs and agg3 is a multi-value metrics agg (eg stats, extended_stats, etc...). In this case, the order will be based on the avg value of agg3.