桶选择器(bucket_selector)聚合

一种执行脚本的父管道聚合,该脚本确定当前桶是否将保留在父多桶聚合中。 指定的度量必须是数字,并且脚本必须返回布尔值。 如果脚本语言是expression,则允许返回值是数值。 在这种情况下,0.0将被当作false,所有其他值将被当作true

与所有管道聚合一样,bucket_selector 聚合在所有其他同级聚合之后执行。 这意味着使用 bucket_selector 聚合来过滤响应中返回的桶并不会节省运行聚合的执行时间。

语法

一个单独的bucket_selector看起来像这样:

{
    "bucket_selector": {
        "buckets_path": {
            "my_var1": "the_sum", 
            "my_var2": "the_value_count"
        },
        "script": "params.my_var1 > params.my_var2"
    }
}

这里,my_var1是脚本中使用的桶路径的变量名,the_sum是该变量使用的度量的路径。

表 8. bucket_selector参数

参数名称 描述 是否必需 默认值

script

为此聚合运行的脚本。 脚本可以是内联、文件或索引化的。(更多详情请参考脚本)

必需

buckets_path

脚本变量及其关联路径到我们希望用于变量的桶的映射(更多详情请参考 buckets_path语法)

必需

gap_policy

在数据中发现间隙时应用的策略(更多详情请参考处理数据中的间隙)

可选

skip

下面这个代码片段仅保留当月总销售额超过200的桶:

POST /sales/_search
{
    "size": 0,
    "aggs" : {
        "sales_per_month" : {
            "date_histogram" : {
                "field" : "date",
                "calendar_interval" : "month"
            },
            "aggs": {
                "total_sales": {
                    "sum": {
                        "field": "price"
                    }
                },
                "sales_bucket_filter": {
                    "bucket_selector": {
                        "buckets_path": {
                          "totalSales": "total_sales"
                        },
                        "script": "params.totalSales > 200"
                    }
                }
            }
        }
    }
}

响应可能像下面这样:

{
   "took": 11,
   "timed_out": false,
   "_shards": ...,
   "hits": ...,
   "aggregations": {
      "sales_per_month": {
         "buckets": [
            {
               "key_as_string": "2015/01/01 00:00:00",
               "key": 1420070400000,
               "doc_count": 3,
               "total_sales": {
                   "value": 550.0
               }
            },
            {
               "key_as_string": "2015/03/01 00:00:00",
               "key": 1425168000000,
               "doc_count": 2,
               "total_sales": {
                   "value": 375.0
               },
            }
         ]
      }
   }
}

已移除2015/02/01 00:00:00的桶,因为其总销售额不足200