> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8a08bda2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> 聚合函数文档

# 聚合函数

聚合函数的工作方式与数据库专家所熟悉的[常规](http://www.sql-tutorial.com/sql-aggregate-functions-sql-tutorial)方式一致。

ClickHouse 还支持：

* [参数化聚合函数](/zh/reference/functions/aggregate-functions/parametric-functions)，除了列之外，还接受其他参数。
* [组合器](/zh/reference/functions/aggregate-functions/combinators)，用于改变聚合函数的行为。

<div id="null-processing">
  ## NULL 处理
</div>

在聚合过程中，所有 `NULL` 参数都会被跳过。如果聚合有多个参数，则只要某一行中有一个或多个参数为 `NULL`，该行就会被忽略。

这条规则有一个例外：函数 [`first_value`](/zh/reference/functions/aggregate-functions/first_value)、[`last_value`](/zh/reference/functions/aggregate-functions/last_value) 及其别名 (分别为 `any` 和 `anyLast`) 在后面跟有修饰符 `RESPECT NULLS` 时，不遵循这一规则。例如，`FIRST_VALUE(b) RESPECT NULLS`。

**示例：**

考虑下面这张表：

```text theme={null}
┌─x─┬────y─┐
│ 1 │    2 │
│ 2 │ ᴺᵁᴸᴸ │
│ 3 │    2 │
│ 3 │    3 │
│ 3 │ ᴺᵁᴸᴸ │
└───┴──────┘
```

假设你需要对 `y` 列中的值进行求和：

```sql theme={null}
SELECT sum(y) FROM t_null_big
```

```text theme={null}
┌─sum(y)─┐
│      7 │
└────────┘
```

现在，你可以使用 `groupArray` 函数基于 `y` 列创建一个数组：

```sql theme={null}
SELECT groupArray(y) FROM t_null_big
```

```text theme={null}
┌─groupArray(y)─┐
│ [2,2,3]       │
└───────────────┘
```

`groupArray` 不会在结果数组中包含 `NULL`。

你可以使用 [COALESCE](/zh/reference/functions/regular-functions/functions-for-nulls#coalesce) 将 `NULL` 替换为适合你使用场景的值。例如：`avg(COALESCE(column, 0))` 会在聚合中使用该列的值；如果为 `NULL`，则使用 0：

```sql theme={null}
SELECT
    avg(y),
    avg(coalesce(y, 0))
FROM t_null_big
```

```text theme={null}
┌─────────────avg(y)─┬─avg(coalesce(y, 0))─┐
│ 2.3333333333333335 │                 1.4 │
└────────────────────┴─────────────────────┘
```

此外，你还可以使用 [Tuple](/zh/reference/data-types/tuple) 来绕过 `NULL` 跳过机制。仅包含 `NULL` 值的 `Tuple` 本身并不是 `NULL`，因此聚合函数不会因为这个 `NULL` 值而跳过该行。

```sql theme={null}
SELECT
    groupArray(y),
    groupArray(tuple(y)).1
FROM t_null_big;

┌─groupArray(y)─┬─tupleElement(groupArray(tuple(y)), 1)─┐
│ [2,2,3]       │ [2,NULL,2,3,NULL]                     │
└───────────────┴───────────────────────────────────────┘
```

请注意，当列作为聚合函数的参数使用时，不会对其进行聚合。例如，不带参数的 [`count`](/zh/reference/functions/aggregate-functions/count) (`count()`) 或带常量参数的 `count(1)` 会统计块中的所有行 (与 GROUP BY 列的值无关，因为它不是参数) ，而 `count(column)` 只会返回 `column` 不为 NULL 的行数。

```sql theme={null}
SELECT
    v,
    count(1),
    count(v)
FROM
(
    SELECT if(number < 10, NULL, number % 3) AS v
    FROM numbers(15)
)
GROUP BY v

┌────v─┬─count()─┬─count(v)─┐
│ ᴺᵁᴸᴸ │      10 │        0 │
│    0 │       1 │        1 │
│    1 │       2 │        2 │
│    2 │       2 │        2 │
└──────┴─────────┴──────────┘
```

下面是一个使用 `RESPECT NULLS` 的 first\_value 示例。我们可以看到，NULL 输入会被保留，返回的是读取到的第一个值，无论它是 NULL 还是非 NULL：

```sql theme={null}
SELECT
    col || '_' || ((col + 1) * 5 - 1) AS range,
    first_value(odd_or_null) AS first,
    first_value(odd_or_null) IGNORE NULLS as first_ignore_null,
    first_value(odd_or_null) RESPECT NULLS as first_respect_nulls
FROM
(
    SELECT
        intDiv(number, 5) AS col,
        if(number % 2 == 0, NULL, number) AS odd_or_null
    FROM numbers(15)
)
GROUP BY col
ORDER BY col

┌─range─┬─first─┬─first_ignore_null─┬─first_respect_nulls─┐
│ 0_4   │     1 │                 1 │                ᴺᵁᴸᴸ │
│ 1_9   │     5 │                 5 │                   5 │
│ 2_14  │    11 │                11 │                ᴺᵁᴸᴸ │
└───────┴───────┴───────────────────┴─────────────────────┘
```