AVG 函数

avg([distinct] expr)

功能描述

AVG 函数用于计算指定表达式在一组数据中的算术平均值。当指定 distinct 关键字时，将计算去重后的平均值。

参数说明

• expr：数值类型表达式，可以是 tinyint、smallint、int、bigint、float、double 或 decimal 类型。

返回类型

• 对于 decimal 类型表达式，AVG 函数返回 decimal 类型的结果。返回值的精度（precision）和标度（scale）可能会增加以适应计算结果。
• 对于其他数值类型表达式，AVG 函数返回 double 类型的结果。

注意事项

• 函数计算过程中，null 值将被忽略，不参与平均值的计算。

使用示例

1. 计算数值列的平均值（不包含 null 值）：

SELECT avg(col) FROM VALUES (1), (2), (3), (4), (null) AS tab(col);
+------------+
| `avg`(col) |
+------------+
| 2.5        |
+------------+

2. 计算去重后数值列的平均值：

SELECT avg(DISTINCT col) FROM VALUES (1), (1), (2), (3), (4), (null) AS tab(col);
+---------------------+
| `avg`(DISTINCT col) |
+---------------------+
| 2.5                 |
+---------------------+