表函数
本页提供 TiDB Cloud Lake 中表函数的参考信息。表函数返回一组行（类似于表），并且可以在查询的 FROM 子句中使用。
数据 schema 与文件检查
| 函数 | 描述 | 示例 |
|---|
| INFER_SCHEMA | 检测文件元信息 schema 并获取列定义 | SELECT * FROM INFER_SCHEMA(LOCATION => '@mystage/data/') |
| INSPECT_PARQUET | 检查 Parquet 文件的结构 | SELECT * FROM INSPECT_PARQUET(LOCATION => '@mystage/data.parquet') |
stage 与查询管理
| 函数 | 描述 | 示例 |
|---|
| LIST_STAGE | 列出 stage 中的文件 | SELECT * FROM LIST_STAGE(LOCATION => '@mystage/data/') |
| RESULT_SCAN | 获取先前查询的结果集 | SELECT * FROM RESULT_SCAN(LAST_QUERY_ID()) |
数据生成
| 函数 | 描述 | 示例 |
|---|
| FLATTEN | 将嵌套的 JSON 或数组数据转换为表格格式 | SELECT * FROM FLATTEN(INPUT => parse_json('[1,2,3]')) |
| 函数 | 描述 | 示例 |
|---|
| SHOW_GRANTS | 显示已授予的权限 | SELECT * FROM SHOW_GRANTS() |
| SHOW_VARIABLES | 显示系统变量 | SELECT * FROM SHOW_VARIABLES() |
| STREAM_STATUS | 显示流状态信息 | SELECT * FROM STREAM_STATUS('mystream') |
| TASK_HISTROY | 显示任务执行历史 | SELECT * FROM TASK_HISTROY('mytask') |
| POLICY_REFERENCES | 返回安全策略与表/视图之间的关联关系 | SELECT * FROM POLICY_REFERENCES(POLICY_NAME => 'mypolicy') |
| TAG_REFERENCES | 返回分配给数据库对象的标签 | SELECT * FROM TAG_REFERENCES('mydb.mytable', 'TABLE') |
| GET_LINEAGE | 返回上游或下游对象及列血缘关系 | SELECT * FROM GET_LINEAGE('mydb.mytable', 'TABLE', 'UPSTREAM') |
存储引擎函数
Iceberg 集成
| 函数 | 描述 | 示例 |
|---|
| ICEBERG_MANIFEST | 显示 Iceberg 表的 manifest 信息 | SELECT * FROM ICEBERG_MANIFEST('mytable') |
| ICEBERG_SNAPSHOT | 显示 Iceberg 表的快照信息 | SELECT * FROM ICEBERG_SNAPSHOT('mytable') |
匿名化
| 函数 | 描述 | 示例 |
|---|
| OBFUSCATE | 数据集匿名化 | SELECT * FROM OBFUSCATE(users) |