Elasticsearch 7.3.0 翻译 - 《Aggregations》 度量聚合 状态聚合

多值度量聚合，计算从聚合文档中提取的数值的统计信息。这些值可以从文档中的特定数字字段中提取，也可以由提供的脚本生成。

返回的统计信息包括：最小值、最大值、总和、计数和平均值。

假设数据由代表学生考试成绩（0到100）的文档组成

POST /exams/_search?size=0
{
    "aggs" : {
        "grades_stats" : { "stats" : { "field" : "grade" } }
    }
}

上面的聚合计算所有文档的等级统计。聚合类型是stats，字段设置定义将计算stats的文档的数字字段。上面将返回以下内容：

{
    ...

    "aggregations": {
        "grades_stats": {
            "count": 2,
            "min": 50.0,
            "max": 100.0,
            "avg": 75.0,
            "sum": 150.0
        }
    }
}

聚合的名称（上面的Grades_Stats）也用作键，通过该键可以从返回的响应中检索聚合结果。

脚本

根据脚本计算成绩统计：

POST /exams/_search?size=0
{
    "aggs" : {
        "grades_stats" : {
             "stats" : {
                 "script" : {
                     "lang": "painless",
                     "source": "doc['grade'].value"
                 }
             }
         }
    }
}

这将把脚本参数解释为具有painless脚本语言且没有脚本参数的内联脚本。要使用存储的脚本，请使用以下语法：

POST /exams/_search?size=0
{
    "aggs" : {
        "grades_stats" : {
            "stats" : {
                "script" : {
                    "id": "my_script",
                    "params" : {
                        "field" : "grade"
                    }
                }
            }
        }
    }
}

脚本值

结果证明，考试远高于学生的水平，需要进行分数修正。我们可以使用值脚本获取新的统计信息：

POST /exams/_search?size=0
{
    "aggs" : {
        "grades_stats" : {
            "stats" : {
                "field" : "grade",
                "script" : {
                    "lang": "painless",
                    "source": "_value * params.correction",
                    "params" : {
                        "correction" : 1.2
                    }
                }
            }
        }
    }
}

缺省值

缺少参数定义如何处理缺少值的文档。默认情况下，它们将被忽略，但也可以将它们视为具有值。

POST /exams/_search?size=0
{
    "aggs" : {
        "grades_stats" : {
            "stats" : {
                "field" : "grade",
                "missing": 0   <1>
            }
        }
    }
}

1. “grade”字段中没有值的文档与值为0的文档属于同一个存储桶。