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

Apache Doris 中文参考:ARRAY_AVG

· 52CE 我爱测

计算数组中所有数值元素的平均值。函数会跳过数组中的 null 值和非数值元素,只对有效的数值元素进行平均值计算。

array_avg

描述

计算数组中所有数值元素的平均值。函数会跳过数组中的 null 值和非数值元素,只对有效的数值元素进行平均值计算。

语法

array_avg(ARRAY<T> arr)

参数

  • arr:ARRAY 类型,要计算平均值的数组。支持列名或常量值。

T 支持的类型:

  • 数值类型:TINYINT、SMALLINT、INT、BIGINT、LARGEINT、FLOAT、DOUBLE、DECIMAL

返回值

返回类型:根据输入类型自动选择

返回值含义:

  • 返回数组中所有有效数值元素的平均值
  • NULL:或数组为空,或所有元素都为 NULL 或无法转换为数值

使用说明:

  • 空数组返回 NULL,只有一个元素的数组返回该元素的值
  • 嵌套数组、MAP、STRUCT 等复杂类型不支持平均值计算,调用会报错
  • 对数组元素中的 null 值:null 元素不参与平均值计算

示例

CREATE TABLE array_avg_test (
    id INT,
    int_array ARRAY<INT>,
    double_array ARRAY<DOUBLE>,
    mixed_array ARRAY<STRING>
)
DUPLICATE KEY(id)
DISTRIBUTED BY HASH(id) BUCKETS 3
PROPERTIES (
    "replication_num" = "1"
);

INSERT INTO array_avg_test VALUES
(1, [1, 2, 3, 4, 5], [1.1, 2.2, 3.3, 4.4, 5.5], ['1', '2', '3', '4', '5']),
(2, [10, 20, 30], [10.5, 20.5, 30.5], ['10', '20', '30']),
(3, [], [], []),
(4, NULL, NULL, NULL),
(5, [1, null, 3, null, 5], [1.1, null, 3.3, null, 5.5], ['1', null, '3', null, '5']);

查询示例:

计算 double_array 的平均值:

SELECT array_avg(double_array) FROM array_avg_test WHERE id = 1;
+-------------------------+
| array_avg(double_array) |
+-------------------------+
|                     3.3 |
+-------------------------+

计算混合类型数组的平均值,字符串会被转换为数值:

SELECT array_avg(mixed_array) FROM array_avg_test WHERE id = 1;
+------------------------+
| array_avg(mixed_array) |
+------------------------+
|                      3 |
+------------------------+

空数组返回 NULL:

SELECT array_avg([]);
+----------------------+
| array_avg(int_array) |
+----------------------+
|                 NULL |
+----------------------+

NULL 数组返回 NULL:

SELECT array_avg(NULL);
+-----------------+
| array_avg(NULL) |
+-----------------+
|            NULL |
+-----------------+

包含 null 的数组,null 元素不参与计算:

SELECT array_avg(int_array) FROM array_avg_test WHERE id = 5;
+----------------------+
| array_avg(int_array) |
+----------------------+
|                    3 |
+----------------------+

复杂类型示例:

嵌套数组类型不支持,报错:

SELECT array_avg([[1,2,3]]);
ERROR 1105 (HY000): errCode = 2, detailMessage = array_avg([[1, 2, 3]]) does not support type: ARRAY<TINYINT>

map 类型不支持,报错:

SELECT array_avg([{'k':1},{'k':2}]);
ERROR 1105 (HY000): errCode = 2, detailMessage = array_avg([map('k', 1), map('k', 2)]) does not support type: MAP<VARCHAR(1),TINYINT>

参数数量错误会报错:

SELECT array_avg([1,2,3], [4,5,6]);
ERROR 1105 (HY000): errCode = 2, detailMessage = Can not found function 'array_avg' which has 2 arity. Candidate functions are: [array_avg(Expression)]

传入非数组类型时会报错:

SELECT array_avg('not_an_array');
ERROR 1105 (HY000): errCode = 2, detailMessage = Can not find the compatibility function signature: array_avg(VARCHAR(12))

Keywords

ARRAY, AVG, ARRAY_AVG

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

资料来源与适用范围

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

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

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