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 日当天各状态的订单数。

http
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。完整响应还会包含耗时和分片信息,关键字段如下。

json
{
  "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,完成订单金额与客户数量的常用指标统计。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

聚合请求结构

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通