# 平均值聚合 原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/current/search-aggregations-metrics-avg-aggregation.html](https://www.elastic.co/guide/en/elasticsearch/reference/current/search-aggregations-metrics-avg-aggregation.html) 譯文鏈接 : [平均值聚合](/pages/viewpage.action?pageId=5505218) 貢獻者 : @yishengxiaoyao single-value計量聚合操作就是從聚合文本中提取的數據進行求平均數的操作。這些值可以是從文本具體的數值屬性中提取的值，也可以是使用腳本生成的。 假設這個數據都是有學生的考試成績（0-100）的文檔組成： ``` { "aggs" : { "avg_grade" : { "avg" : { "field" : "grade" } } } } ``` 上面的聚合操作就是計算所有文檔的平均值。這個聚合操作的類型是avg，并且使用field來定義要計算文檔中的屬性。如下所示： ``` { ... "aggregations": { "avg_grade": { "value": 75 } } } ``` 聚合操作的名可以也可以作為聚合操作返回的關鍵字（例如上面的avg）。 ## Script 使用腳本計算平均值： ``` { ..., "aggs" : { "avg_grade" : { "avg" : { "script" : { "inline" : "doc['grade'].value", "lang" : "painless" } } } } } ``` 將會解釋script參數作為無并發腳本語言和無腳本參數的內聯腳本。一個文件腳本中包含如下參數和語法規范： ``` { ..., "aggs" : { "avg_grade" : { "avg" : { "script" : { "file": "my_script", "params": { "field": "grade" } } } } } } ``` | 用戶小貼士 | 在索引腳本文件中可以使用id參數取代file參數。 | | --- | --- | ## Value Scripts 事實證明考試是高于學生的水平的需要對學生的成績進行校對。我們可以使用下面的腳本獲取新的平均數： ``` { "aggs" : { ... "aggs" : { "avg_corrected_grade" : { "avg" : { "field" : "grade", "script" : { "lang": "painless", "inline": "_value * params.correction", "params" : { "correction" : 1.2 } } } } } } } ``` ## Missing Value 這個missing參數就是定義文檔怎樣處理缺省的文檔。默認情況下，它們會被忽略，也可以視它們為具體指。 ``` { "aggs" : { "grade_avg" : { "avg" : { "field" : "grade", "missing": 10 } } } } ``` 在文檔中，如果grade這個屬性沒有的值話，就會默認為10.