值构造函数
概述
值构造函数用于构造复合数据类型的值,包括行(ROW)、数组(ARRAY)和映射(MAP)。AI DataLake支持SQL标准中的隐式和显式行构造、数组构造和映射构造能力。
更多内容请参考Value Construction Functions。
适用场景
- 复合行构造:使用ROW构造函数创建包含多个字段的行值。
- 数组构造:使用ARRAY构造函数创建数组值,用于IN子句、UNNEST操作等。
- 映射构造:使用MAP构造函数创建键值对映射,用于配置参数、属性存储等。
- 窗口定义:使用行数间隔构造函数辅助窗口定义。
约束与限制
- 隐式行构造(使用圆括号)要求至少两个字段,显式ROW构造函数可接受任意数量的字段。
- ARRAY和MAP构造函数中的值类型应保持一致或兼容。
- MAP构造函数的参数必须成对出现,即键值对数量必须为偶数。
- 行数间隔构造函数(N rows)仅Table API支持,SQL中不可用。
语法结构
| 语法 | 返回类型 | 说明 | 示例 |
|---|---|---|---|
| implicit constructor with parenthesis (value1 [, value2]*) explicit ROW constructor with ROW(value1 [, value2]*) | ROW | 从值列表(value1, value2,…)创建行。 隐式行构造器要求至少两个字段。显式行构造器可处理任意数量的字段。两者均支持任意表达式作为字段。 | -- 隐式行构造器(至少两个字段) SELECT (1, 'hello'); -- 显式行构造器(可处理任意数量字段) SELECT ROW(1); SELECT ROW(1, 'hello', TRUE); -- 使用表达式作为字段 SELECT ROW(orderId, orderAmount) FROM orders; |
| ARRAY ‘[’ value1 [, value2 ]* ‘]’ | ARRAY | 从值列表(value1, value2, …)创建数组。 | -- 从字面量创建数组 SELECT ARRAY [1, 2, 3]; -- 从表达式创建数组 SELECT ARRAY [orderId, orderAmount] FROM orders; -- 嵌套数组 SELECT ARRAY [ARRAY [1, 2], ARRAY [3, 4]]; |
| MAP ‘[’ value1, value2 [, value3, value4 ]* ‘]’ | MAP | 从键值对列表((value1, value2), (value3, value4), …)创建映射。 | -- 从字面量创建映射 SELECT MAP ['a', 1, 'b', 2]; -- 从表达式创建映射 SELECT MAP ['orderId', orderId, 'amount', orderAmount] FROM orders; |