# 平均值聚合 原文链接 : [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.