NoSQL 与搜索 / 系统课时
聚合请求结构
聚合请求结构
本课通过一个可直接执行的订单统计示例,拆解 Elasticsearch 聚合请求中的 query、aggs 与 size,并说明响应里的 aggregations 如何对应请求名称,以及查询范围为什么会直接改变统计结果。
学习目标
- 读懂搜索请求中查询条件与聚合定义的分工
- 根据聚合名称定位响应中的桶和统计值
- 验证时间范围变化对聚合结果的影响
聚合请求与结果结构
聚合仍然通过 _search 接口发送。顶层 query 先确定参与统计的文档集合,aggs 或完整写法 aggregations 再对这些文档分组或计算指标。只关注统计时,通常把 size 设为 0,避免返回具体文档。
aggs 中的 by_status 是自定义聚合名称,响应会在 aggregations.by_status 下返回对应结果。名称应表达业务含义,因为后续程序通常依赖它读取数据。

查询范围如何影响统计
聚合默认只处理顶层 query 命中的文档。日期范围、状态条件或权限过滤一旦改变,桶中的 doc_count 和指标值都会随之变化。因此,排查“统计不对”时,应先验证查询命中文档数,再检查聚合定义。
hits.total.value 表示查询范围内的文档数量;各桶的 doc_count 表示其中落入该分组的数量。两者口径不同:前者是总样本数,后者是某个桶的样本数。
完整验证示例
以下请求可直接在 Kibana Dev Tools 中依次执行。示例先创建索引和四条订单,再统计 2026 年 8 月 1 日当天各状态的订单数。
DELETE orders?ignore_unavailable=true
PUT orders
{
"mappings": {
"properties": {
"status": { "type": "keyword" },
"amount": { "type": "scaled_float", "scaling_factor": 100 },
"created_at": { "type": "date" }
}
}
}
POST _bulk?refresh=wait_for
{"index":{"_index":"orders","_id":"1"}}
{"status":"PAID","amount":100,"created_at":"2026-08-01T09:00:00Z"}
{"index":{"_index":"orders","_id":"2"}}
{"status":"PAID","amount":150,"created_at":"2026-08-01T10:00:00Z"}
{"index":{"_index":"orders","_id":"3"}}
{"status":"REFUNDED","amount":50,"created_at":"2026-08-01T11:00:00Z"}
{"index":{"_index":"orders","_id":"4"}}
{"status":"PAID","amount":80,"created_at":"2026-07-31T23:00:00Z"}
GET orders/_search
{
"size": 0,
"query": {
"range": {
"created_at": {
"gte": "2026-08-01T00:00:00Z",
"lt": "2026-08-02T00:00:00Z"
}
}
},
"aggs": {
"by_status": {
"terms": {
"field": "status"
}
}
}
}预期结果中,查询范围命中 3 条文档,PAID 桶为 2,REFUNDED 桶为 1。完整响应还会包含耗时和分片信息,关键字段如下。
{
"hits": {
"total": {
"value": 3,
"relation": "eq"
},
"hits": []
},
"aggregations": {
"by_status": {
"doc_count_error_upper_bound": 0,
"sum_other_doc_count": 0,
"buckets": [
{
"key": "PAID",
"doc_count": 2
},
{
"key": "REFUNDED",
"doc_count": 1
}
]
}
}
}把范围起点改为 2026-07-31T00:00:00Z 后,总命中数会变为 4,PAID 桶会变为 3。这说明聚合定义没有变化,变化来自参与统计的文档集合。
本课总结
- 顶层
query决定聚合样本,aggs定义统计方式,size: 0用于只取统计结果 - 请求中的聚合名称会原样出现在响应的
aggregations下 - 统计异常应先核对查询范围和命中文档数,再检查桶或指标配置
下一课预告
下一课将使用 min、max、sum、avg、cardinality 和 stats,完成订单金额与客户数量的常用指标统计。