テーブル関数
このページでは、TiDB Cloud Lake のテーブル関数に関するリファレンス情報を提供します。テーブル関数は、行の集合(テーブルに類似)を返し、クエリの FROM 句で使用できます。
データスキーマとファイル検査
| 関数 | 説明 | 例 |
|---|
| INFER_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_HISTORY | タスク実行履歴を表示します | SELECT * FROM TASK_HISTORY('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 テーブルのマニフェスト情報を表示します | SELECT * FROM ICEBERG_MANIFEST('mytable') |
| ICEBERG_SNAPSHOT | Iceberg テーブルのスナップショット情報を表示します | SELECT * FROM ICEBERG_SNAPSHOT('mytable') |
匿名化
| 関数 | 説明 | 例 |
|---|
| OBFUSCATE | データセットの匿名化 | SELECT * FROM OBFUSCATE(users) |