【Elasticsearch】cumulative_cardinality

1.定义与用途

`cumulative_cardinality`是一种父级管道聚合（Parent Pipeline Aggregation），用于在父级直方图（`histogram`）或日期直方图（`date_histogram`）聚合中计算累计基数。它主要用于统计在某个时间范围内“新增”的唯一项目数量，例如每天访问网站的新访客数量。

2.工作原理

`cumulative_cardinality`聚合会计算每个时间桶中的唯一值数量，并将这些值累计起来。它依赖于父级直方图中的某个基数聚合（`cardinality`）结果。具体来说，它会从第一个时间桶开始，逐个累加每个桶中的唯一值数量，从而得到每个时间点的累计唯一值数量。

3.参数

• `buckets_path`：必需参数，指定要计算累计基数的基数聚合路径。

• `format`：可选参数，定义输出值的格式。如果指定，格式化的值将返回在聚合的`value_as_string`属性中。

4.应用场景

`cumulative_cardinality`聚合特别适用于以下场景：

• 统计新增用户：例如，每天访问网站的新访客数量。

• 分析趋势：通过累计唯一值的变化，可以分析数据的增长趋势。

5.示例

假设我们有一个索引`user_hits`，其中记录了每次用户访问的日期（`timestamp`字段）和用户ID（`user_id`字段）。我们希望计算每天新增的唯一用户数量。

查询示例：

```json

GET /user_hits/_search

{

  "size": 0,

  "aggs": {

    "users_per_day": {

      "date_histogram": {

        "field": "timestamp",

        "calendar_interval": "day"

      },

      "aggs": {

        "distinct_users": {

          "cardinality": {

            "field": "user_id"

          }

        },

        "total_new_users": {

          "cumulative_cardinality": {

            "buckets_path": "distinct_users"

          }

        }

      }

    }

  }

}

```

 

 

响应结果：

 

```json

{

   "took": 11,

   "timed_out": false,

   "_shards": ...,

  &n