Bucket Script Aggregation（桶腳本聚合） · Elasticsearch 5.4 中文文檔

# Bucket Script Aggregation（桶腳本聚合）警告此功能是實驗性的，可能會在未來的版本中完全更改或刪除。Elastic將采取最大的努力來解決任何問題，但實驗功能不受SLA官方功能的支持。父級管道聚合，它執行一個腳本，它可以在父級多桶聚合中指定度量參數執行每個桶計算。指定的度量必須是數字，腳本必須返回一個數值。 ## Syntax（語法） bucket_script聚合看起來像這樣： ``` { "bucket_script": { "buckets_path": { "my_var1": "the_sum", #1 "my_var2": "the_value_count" }, "script": "params.my_var1 / params.my_var2" } } ``` | 1 | 這里，my_var1是這個桶的路徑中使用腳本中的變量的名字，the_sum是路徑的度量所使用的變量。 | ## Table?11.?`bucket_script`?Parameters（Table 11.bucket_script參數） | 參數名稱 | 描述 | 是否必要 | 默認值 | | --- | --- | --- | --- | | `script` | 在這個聚合上運行的腳本。這個腳本可以是內置的，文件或索引。（詳細信息，請查閱Scripting） | 必須 | ? | | `buckets_path` | 腳本變量的映射，以及我們希望用于桶的變量的相關路徑（相關詳細信息，請參閱“buckets_path Syntax”一節） | 必須 | ? | | `gap_policy` | 在數據中找到差異時應用的策略（相關詳情，請參閱“Dealing with gaps in the data”一節） | 可選 | `skip` | | `format` | 應用于此聚合的輸出值的格式 | 可選 | `null` | 以下代碼計算了T恤銷售額與每月銷售額的比例： ``` POST /sales/_search { "size": 0, "aggs" : { "sales_per_month" : { "date_histogram" : { "field" : "date", "interval" : "month" }, "aggs": { "total_sales": { "sum": { "field": "price" } }, "t-shirts": { "filter": { "term": { "type": "t-shirt" } }, "aggs": { "sales": { "sum": { "field": "price" } } } }, "t-shirt-percentage": { "bucket_script": { "buckets_path": { "tShirtSales": "t-shirts>sales", "totalSales": "total_sales" }, "script": "params.tShirtSales / params.totalSales * 100" } } } } } } ``` 以下是響應信息： ``` { "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 }, "t-shirts": { "doc_count": 1, "sales": { "value": 200.0 } }, "t-shirt-percentage": { "value": 36.36363636363637 } }, { "key_as_string": "2015/02/01 00:00:00", "key": 1422748800000, "doc_count": 2, "total_sales": { "value": 60.0 }, "t-shirts": { "doc_count": 1, "sales": { "value": 10.0 } }, "t-shirt-percentage": { "value": 16.666666666666664 } }, { "key_as_string": "2015/03/01 00:00:00", "key": 1425168000000, "doc_count": 2, "total_sales": { "value": 375.0 }, "t-shirts": { "doc_count": 1, "sales": { "value": 175.0 } }, "t-shirt-percentage": { "value": 46.666666666666664 } } ] } } } ``` 原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/current/search-aggregations-pipeline-bucket-script-aggregation.html](https://www.elastic.co/guide/en/elasticsearch/reference/current/search-aggregations-pipeline-bucket-script-aggregation.html)（修改該鏈接為官網對應的鏈接）譯文鏈接 : [http://www.apache.wiki/pages/viewpage.action?pageId=10030393](http://www.apache.wiki/pages/viewpage.action?pageId=10030393)（修改該鏈接為 **ApacheCN** 對應的譯文鏈接）貢獻者 : [曾少峰](/display/~zengshaofeng)，[ApacheCN](/display/~apachecn)，[Apache中文網](/display/~apachechina)