Aggregate Functions

[Top]

聚合函数

下面显示的聚合函数默认可用。使用 sqlite3_create_function() API 可以添加以 C 语言编写的其他集合函数。

在任何使用单个参数的聚合函数中，该参数可以以关键字 DISTINCT 开头。在这种情况下，重复元素在被传递到聚合函数之前被过滤。例如，函数 “count(distinct X)” 将返回列 X 的不同值的数量，而不是列 X 中的非空值的总数。

• avg(X)

• count(*)

• count(X)

• group_concat(X)

• group_concat(X,Y)

• max(X)

• min(X)

• sum(X)

• total(X)

avg(X)

avg() 函数返回组内所有非空X的平均值。看起来不像数字的字符串和 BLOB 值被解释为0.只要至少有一个非 NULL 输入，即使所有输入都是整数，avg() 的结果也始终是浮点值。当且仅当没有非 NULL 输入时，avg() 的结果为 NULL 。

count(X)

count(*)

count(X) 函数返回一个组中X不为 NULL 的次数。count（*）函数（不带参数）返回组中的总行数。

group_concat(X)

group_concat(X,Y)

group_concat() 函数返回一个字符串，它是 X 的所有非空值的并置。如果参数 Y 存在，那么它被用作 X 实例之间的分隔符。如果省略 Y ，则使用逗号（“，”）作为分隔符。级联元素的顺序是任意的。

max(X)

max() 聚合函数返回组中所有值的最大值。最大值是在同一列的 ORDER BY 中最后返回的值。当且仅当组中没有非 NULL 值时，聚合 max() 返回 NULL 。

min(X)

min() 聚合函数返回组中所有值的最小非空值。最小值是将出现在列的 ORDER BY 中的第一个非 NULL 值。当且仅当组中没有非 NULL 值时，聚合 min() 返回 NULL 。

sum(X)

total(X)

sum() 和 total() 聚合函数返回组中所有非 NULL 值的总和。如果没有非 NULL 输入行，则 sum() 返回 NULL ，但 total() 返回0.0。对于没有行的总和，NULL 通常不是有用的结果，但 SQL 标准要求它并且大多数其他 SQL 数据库引擎以这种方式实现 sum() ，所以 SQLite 以相同的方式执行它以便兼容。提供非标准的 total() 函数是一种便捷的方式，可以解决 SQL 语言中的这个设计问题。

total() 的结果总是一个浮点值。如果所有非 NULL 输入都是整数，则 sum() 的结果是一个整数值。如果对 sum() 的任何输入既不是整数也不是 NULL ，那么 sum() 返回一个浮点值，它可能是真实和的近似值。

如果所有输入都是整数或 NULL ，并且计算过程中的任何一点发生整数溢出，则 Sum() 将抛出“整数溢出”异常。Total() 永远不会引发整数溢出。

 SQLite is in the Public Domain.