平均值聚合 · my-elasticsearch-cn

# 平均值聚合 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.