テーブル関数

テーブル関数は、単一のスカラー値の代わりに行のセットを返します。テーブル関数は SQL ステートメントの FROM 句に表示され、スカラー関数としては使用できません。テーブル関数は、入力としてスカラー式を取ります。

注釈

SQL クエリまたは JavaScriptから行を返すテーブル UDFs を定義することもできます。詳細については、 UDFs (ユーザー定義関数) をご参照ください。

このトピックの内容:

システム定義のテーブル関数のリスト

Snowflakeは、次のシステム定義のテーブル関数を提供します。

サブカテゴリ

関数

注意

データのロード

VALIDATE

詳細については、 Snowflakeへのデータのロード をご参照ください。

データ生成

GENERATOR

データ変換

SPLIT_TO_TABLE

STRTOK_SPLIT_TO_TABLE

オブジェクトモデリング

GET_OBJECT_REFERENCES

半構造化クエリ

FLATTEN

詳細については、 半構造化データのクエリ をご参照ください。

クエリ結果

RESULT_SCAN

別の SQL 操作からの出力に対して SQL 操作を実行するために使用できます(例: SHOW)

履歴と使用情報情報スキーマ):

ユーザーログイン

LOGIN_HISTORY , LOGIN_HISTORY_BY_USER

クエリ

QUERY_HISTORY , QUERY_HISTORY_BY_*

ウェアハウスとストレージの使用

DATABASE_STORAGE_USAGE_HISTORY

WAREHOUSE_LOAD_HISTORY

WAREHOUSE_METERING_HISTORY

STAGE_STORAGE_USAGE_HISTORY

列レベルのセキュリティ

POLICY_REFERENCES

データベースの複製

DATABASE_REFRESH_HISTORY DATABASE_REFRESH_PROGRESS , DATABASE_REFRESH_PROGRESS_BY_JOB REPLICATION_USAGE_HISTORY

詳細については、 複数のアカウント間におけるデータベースの複製 をご参照ください。

データのロードと転送

COPY_HISTORY

DATA_TRANSFER_HISTORY

PIPE_USAGE_HISTORY

VALIDATE_PIPE_LOAD

データクラスタリング(テーブル内)

AUTOMATIC_CLUSTERING_HISTORY

詳細については、 自動クラスタリング をご参照ください。

外部関数

EXTERNAL_FUNCTIONS_HISTORY

詳細については、 外部関数 をご参照ください。

外部テーブルのメンテナンス

EXTERNAL_TABLE_FILES

詳細については、 外部テーブルの使用 をご参照ください。

EXTERNAL_TABLE_FILE_REGISTRATION_HISTORY

マテリアライズドビューのメンテナンス

MATERIALIZED_VIEW_REFRESH_HISTORY

詳細については、 マテリアライズドビューの使用 をご参照ください。

SCIM メンテナンス

REST_EVENT_HISTORY

詳細については、 SCIMを使用した監査 をご参照ください。

検索最適化のメンテナンス

SEARCH_OPTIMIZATION_HISTORY

詳細については、 検索最適化サービスの使用 をご参照ください。

タスクのメンテナンス

TASK_DEPENDENTS

詳細については、 タスクを使用したスケジュールでの SQL ステートメントの実行 をご参照ください。

TASK_HISTORY

構文

SELECT ...
  FROM [ <input_table> [ [AS] <alias_1> ] ,
         [ LATERAL ]
       ]
       TABLE( <table_function>( [ <arg_1> [, ... ] ] ) ) [ [ AS ] <alias_2> ];

関数固有の構文については、個々のシステム定義のテーブル関数のドキュメントをご参照ください。

使用上の注意

  • テーブル関数は、 LATERAL 構造を使用して行のセットに適用することもできます。

  • テーブル式の使用を有効にするために、Snowflakeは、クエリおよびサブクエリの FROM 句でテーブル式の ANSI/ISO 標準構文をサポートします。この構文は、式が単一の行ではなく行のコレクションを返すことを示すために使用されます。

  • この ANSI/ISO 構文は、 SELECT リストの FROM 句のみで有効です。他のコンテキストでは、コレクションサブクエリの仕様からこれらのキーワードと括弧を省略できません。