Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

聚合函数

View as MarkdownEdit this pageReport an issueSet up docs MCP

聚合函数的工作方式与数据库专家所熟悉的常规方式一致。

ClickHouse 还支持：

NULL 处理

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

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

示例：

考虑下面这张表：

┌─x─┬────y─┐
│ 1 │    2 │
│ 2 │ ᴺᵁᴸᴸ │
│ 3 │    2 │
│ 3 │    3 │
│ 3 │ ᴺᵁᴸᴸ │
└───┴──────┘

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

SELECT sum(y) FROM t_null_big
┌─sum(y)─┐
│      7 │
└────────┘

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

SELECT groupArray(y) FROM t_null_big
┌─groupArray(y)─┐
│ [2,2,3]       │
└───────────────┘

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

你可以使用 COALESCE 将 NULL 替换为适合你使用场景的值。例如：avg(COALESCE(column, 0)) 会在聚合中使用该列的值；如果为 NULL，则使用 0：

SELECT
    avg(y),
    avg(coalesce(y, 0))
FROM t_null_big
┌─────────────avg(y)─┬─avg(coalesce(y, 0))─┐
│ 2.3333333333333335 │                 1.4 │
└────────────────────┴─────────────────────┘

此外，你还可以使用 Tuple 来绕过 NULL 跳过机制。仅包含 NULL 值的 Tuple 本身并不是 NULL，因此聚合函数不会因为这个 NULL 值而跳过该行。

SELECT
    groupArray(y),
    groupArray(tuple(y)).1
FROM t_null_big;

┌

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

SELECT
    v,
    count(1),
    count(v)
FROM
(
    SELECT if(number < 10, NULL, number % 3) AS v
    FROM numbers(15)
)
GROUP BY v

┌

下面是一个使用 RESPECT NULLS 的 first_value 示例。我们可以看到，NULL 输入会被保留，返回的是读取到的第一个值，无论它是 NULL 还是非 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

┌
Navigation