更新时间:2026-11-06 GMT+08:00
分享

值构造函数

概述

值构造函数用于构造复合数据类型的值,包括行(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;

相关文档