大网数据广告活动
数据库部署与 SQL 参考

Apache Doris 中文参考:AVG

· 52CE 我爱测

返回所选列或表达式的平均值,如果组内的所有记录均为 NULL,则该函数返回 NULL 。 对于 Decimal 类型的输入,返回值类型为 Decimal 。其他数值类型的返回值为 Double 。

描述

计算指定列或表达式的所有非 NULL 值的平均值。

语法

AVG([DISTINCT] <expr>)

参数

参数 说明
<expr> 是一个表达式或列,通常是一个数值列或者能够转换为数值的表达式,支持类型为 TinyInt,SmallInt,Integer,BigInt,LargeInt,Double,Decimal 。
[DISTINCT] 是一个可选的关键字,表示对 expr 中的重复值进行去重后再计算平均值。

返回值

返回所选列或表达式的平均值,如果组内的所有记录均为 NULL,则该函数返回 NULL 。 对于 Decimal 类型的输入,返回值类型为 Decimal 。其他数值类型的返回值为 Double 。

举例

-- setup
create table t1(
        k_tinyint tinyint,
        k_smallint smallint,
        k_int int,
        k_bigint bigint,
        k_largeint largeint,
        k_double double,
        k_decimal decimalv3(10, 5),
        k_null_int int
) distributed by hash (k_int) buckets 1
properties ("replication_num"="1");
insert into t1 values 
    (1, 10, 100, 1000, 10000, 1.1, 222.222, null),
    (2, 20, 200, 2000, 20000, 2.2, 444.444, null),
    (3, 30, 300, 3000, 30000, 3.3, null, null);
select avg(k_tinyint) from t1;

TinyInt 类型的平均值计算,[1,2,3]的平均值为2。

+----------------+
| avg(k_tinyint) |
+----------------+
|              2 |
+----------------+
select avg(k_smallint) from t1;

SmallInt 类型的平均值计算,[10,20,30]的平均值为20。

+-----------------+
| avg(k_smallint) |
+-----------------+
|              20 |
+-----------------+
select avg(k_int) from t1;

Integer 类型的平均值计算,[100,200,300]的平均值为200。

+------------+
| avg(k_int) |
+------------+
|        200 |
+------------+
select avg(k_bigint) from t1;

BigInt 类型的平均值计算,[1000,2000,3000]的平均值为2000。

+---------------+
| avg(k_bigint) |
+---------------+
|          2000 |
+---------------+
select avg(k_largeint) from t1;

LargeInt 类型的平均值计算,[10000,20000,30000]的平均值为20000。

+-----------------+
| avg(k_largeint) |
+-----------------+
|           20000 |
+-----------------+
select avg(k_double) from t1;

Double 类型的平均值计算,[1.1,2.2,3.3]的平均值为2.2。

| avg(k_double)      |
+--------------------+
| 2.1999999999999997 |
select avg(k_decimal) from t1;

Decimal 类型的平均值计算,[222.222,444.444,null]的平均值为333.333。

+----------------+
| avg(k_decimal) |
+----------------+
|      333.33300 |
+----------------+
select avg(k_null_int) from t1;

对于输入数据均为 NULL 值的情况,返回 NULL 值。

+-----------------+
| avg(k_null_int) |
+-----------------+
|            NULL |
+-----------------+
select avg(distinct k_bigint) from t1;

使用 DISTINCT 关键字进行去重计算,[1000,2000,3000]去重后平均值为2000。

+-----------------------+
| avg(distinct k_bigint) |
+-----------------------+
|                  2000 |
+-----------------------+

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。