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

Apache Doris 中文参考:ARRAY_PRODUCT

· 52CE 我爱测

计算数组中所有元素的乘积。函数会遍历数组中的所有元素,将它们相乘并返回结果。

array_product

描述

计算数组中所有元素的乘积。函数会遍历数组中的所有元素,将它们相乘并返回结果。

语法

array_product(ARRAY<T> arr)

参数

  • arr:ARRAY 类型,要计算乘积的数组

T 支持的类型:

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

返回值

返回类型:T

返回值含义:

  • 返回数组中所有元素的乘积
  • NULL:如果数组为空、数组为 NULL,或者所有元素都为 NULL

使用说明:

  • 函数会跳过数组中的 NULL 值,只对非 NULL 元素进行乘积计算
  • 如果数组中所有元素都为 NULL,返回 NULL
  • 空数组返回 NULL
  • 复杂类型(MAP、STRUCT、ARRAY)不支持乘积计算,调用会报错
  • 对数组元素中的 null 值:null 元素不参与乘积计算

查询示例:

计算整数数组的乘积:

SELECT array_product([1, 2, 3, 4, 5]);
+--------------------------------+
| array_product([1, 2, 3, 4, 5]) |
+--------------------------------+
|                            120 |
+--------------------------------+

计算浮点数数组的乘积:

SELECT array_product([1.1, 2.2, 3.3, 4.4, 5.5]);
+------------------------------------------+
| array_product([1.1, 2.2, 3.3, 4.4, 5.5]) |
+------------------------------------------+
|                                 193.2612 |
+------------------------------------------+

计算包含 null 的数组的乘积:

SELECT array_product([1, null, 3, null, 5]);
+----------------------------------------+
| array_product([1, null, 3, null, 5])  |
+----------------------------------------+
| 15.0                                   |
+----------------------------------------+

计算布尔数组的乘积(true=1, false=0):

SELECT array_product([true, false, true, true]);
+------------------------------------------+
| array_product([true, false, true, true]) |
+------------------------------------------+
|                                        0 |
+------------------------------------------+

空数组返回 NULL:

SELECT array_product([]);
+----------------------+
| array_product([])    |
+----------------------+
| NULL                 |
+----------------------+

所有元素都为 null 的数组返回 NULL:

SELECT array_product([null, null, null]);
+----------------------------------+
| array_product([null, null, null]) |
+----------------------------------+
| NULL                             |
+----------------------------------+

复杂类型示例:

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

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

map 类型不支持,报错:

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

参数数量错误会报错:

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

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

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

Keywords

ARRAY, PRODUCT, ARRAY_PRODUCT

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

资料来源与适用范围

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

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

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