ARRAY_PRODUCT
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]) |
+------------------------------------------+
| 190.8 |
+------------------------------------------+
计算包含 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