avg 聚合函数

返回从组的值计算出的平均值。

语法

avg( [ALL | DISTINCT] expr) [FILTER ( WHERE cond ) ]

参数

  • expr:计算结果为数值或间隔的表达式。
  • cond:一个可选的布尔表达式,可筛选用于聚合的行。

返回

结果类型的计算方式为参数:

  • DECIMAL(p, s):结果类型为 DECIMAL(p + 4, s + 4) 。 如果达到 DECIMAL 的最大精度,则位数的增加将受到限制,以避免丢失有效数字。
  • 年月间隔:结果为 INTERVAL YEAR TO MONTH
  • day-time interval:结果为 INTERVAL YEAR TO SECOND
  • 在所有其他情况下,结果为 DOUBLE。

将忽略组内的 NULL。 如果组为空或仅包含 NULL,则结果为 NULL。

如果指定了 DISTINCT,则会在删除重复项后计算平均值。

此函数是 mean 聚合函数的同义词。

示例

> SELECT avg(col) FROM VALUES (1), (2), (3) AS tab(col);
 2.0

> SELECT avg(DISTINCT col) FROM VALUES (1), (1), (2) AS tab(col);
 1.5

> SELECT avg(col) FROM VALUES (1), (2), (NULL) AS tab(col);
 1.5

> SELECT avg(vol) FROM VALUES (INTERVAL '1' YEAR), (INTERVAL '2' YEAR) AS tab(col);
 1-6