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

值访问函数

概述

值访问函数用于访问复合数据类型(如Tuple、POJO等)中的字段值,支持按名称访问单个字段和展开所有子字段。AI DataLake支持SQL标准中通过点号语法访问复合类型字段的能力。

更多内容请参考Value Access Functions。

适用场景

  • 字段访问:从复合类型(如Tuple、POJO)中按名称获取特定字段的值。
  • 字段展开:将复合类型的所有直接子类型展开为独立字段,用于SELECT查询中展开嵌套结构。

约束与限制

  • 点号访问语法(tableName.compositeType.field)仅适用于Flink复合类型(Tuple、POJO等),不适用于普通标量字段。
  • 展开操作(tableName.compositeType.*)将每个直接子类型转换为独立字段,字段命名通常与原始字段类似,但使用美元符号分隔(如mypojo$mytuple$f0)。
  • 展开操作仅展开直接子类型,不会递归展开嵌套的复合类型。

语法结构

语法

返回类型

说明

示例

tableName.compositeType.field

ANY

按名称返回Flink复合类型(如Tuple、POJO)中字段的值。

-- 假设表myTable包含ROW类型字段myRow(field1 INT, field2 STRING) 
-- 按名称访问field1字段 
SELECT myTable.myRow.field1 FROM myTable; -- 按名称访问嵌套结构中的字段
-- 假设person为ROW(name STRING, age INT)
SELECT myTable.person.name FROM myTable;

tableName.compositeType.*

ANY

返回Flink复合类型(如Tuple、POJO)的扁平化表示,将每个直接子类型转换为独立字段。

在大多数情况下,扁平化表示的字段名称与原始字段类似,但使用美元符号作为分隔符(如mypojo$mytuple$f0)。

-- 假设表myTable包含ROW类型字段myRow(field1 INT, field2 STRING) 
-- 扁平化展开myRow的所有字段,展开后字段名称使用美元符号分隔符(如mypojo$mytuple$f0) 
SELECT myTable.myRow.* FROM myTable;

相关文档