Skip to main content

统计聚合 stats

Stats Aggregation

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

返回的统计数据包括:min、max、sum、count和avg。

假设数据由代表学生考试成绩(0至100)的文件组成

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

上述汇总计算所有文档的成绩统计。聚合类型为stats,字段设置定义了要计算统计信息的文档的数字字段。上面将返回以下内容:

{
...

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

聚合的名称(grades_stats)也用作键,通过该键可以从返回的响应中检索聚合结果。

Script

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

参数方式

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

Value Script

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

Missing value

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

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