カテゴリ:

Information Schema、 テーブル関数

DYNAMIC_TABLE_GRAPH_HISTORY

Snowflake logo in black (no text) プレビュー機能 --- オープン

アカウントで利用可能です。

このテーブル関数は、現在のアカウント内にあるすべての 動的テーブル の情報を返します。この情報には、動的テーブルとベーステーブルの依存関係が含まれます。一般的な使用方法は、パイプラインの一部である動的テーブルすべてを識別することです。

この関数の出力では、各行が特定のプロパティを持つ動的テーブルを表します。VALID_FROM と VALID_TO の列は、動的テーブルの記述が有効であった（つまり、動的テーブルを正確に説明していた）時間の範囲を指定します。

TARGET_LAG を変更するなど、動的テーブルに変更を加えると、新しいエントリが作成されます。

このテーブル関数は、現在の時刻から1日以内の VALID_TO 値を持つ説明のみを提供します。

構文

DYNAMIC_TABLE_GRAPH_HISTORY(
  [ AS_OF => <constant_expr> ]
  [ , HISTORY_START => <constant_expr> [ , HISTORY_END => <constant_expr> ] ]
)
Copy

引数

すべての引数はオプションです。引数が提供されない場合は、現在存在する動的テーブルの最新の説明のみが返されます。

AS_OF => constant_expr

グラフの状態を返す時間（TIMESTAMP_LTZ 形式）。 DYNAMIC_TABLE_REFRESH_HISTORY 関数の出力にある REFRESH_VERSION 列の値に対応する時間を指定できます。

HISTORY_START => constant_expr、 . HISTORY_END => constant_expr

動的テーブルのリフレッシュ履歴の日付/時間範囲。HISTORY_START は、データを返す最も古い日時（当日を含む）を指定します。HISTORY_END。これは HISTORY_START で指定する必要があり、データを返す終了日時を指定します。

出力

この関数は、次の列を返します。

列名

データ型

説明

NAME

TEXT

動的テーブルの名前。

SCHEMA_NAME

TEXT

動的テーブルを含むスキーマの名前。

DATABASE_NAME

TEXT

動的テーブルを含むデータベースの名前。

QUALIFIED_NAME

TEXT

動的テーブルのグラフに表示される動的テーブルの完全修飾名。これは、出力を DYNAMIC_TABLE_REFRESH_HISTORY 関数の出力と結合するために使用できます。

INPUTS

OBJECTs の ARRAY

各 OBJECT は、この動的テーブルへの入力として機能するテーブル、ビュー、または動的テーブルを表し、以下で構成されています。

  • name (TEXT): 完全修飾名。

  • kind (TEXT): 入力（TABLE、 VIEW、または DYNAMIC TABLE）の型。

TARGET_LAG_TYPE

TEXT

次のいずれか:

  • USER_DEFINED - 動的テーブルに指定された TARGET_LAG パラメーターよって決定されます。

  • DOWNSTREAM - DOWNSTREAM TARGET_LAG を持つ動的テーブルを示します。詳細については、 動的テーブルリフレッシュについて をご参照ください

TARGET_LAG_SEC

NUMBER

この動的テーブルのターゲットラグタイム（秒単位）。これは、動的テーブルの TARGET_LAG パラメーターで指定された値です。

QUERY_TEXT

TEXT

この動的テーブルの SELECT ステートメント。

VALID_FROM

TIMESTAMP_LTZ

動的テーブルの説明はこの時間以降も有効です。

VALID_TO

TIMESTAMP_LTZ

存在する場合、動的テーブルの説明はこの時点まで有効です。Nullの場合でも、説明は正確です。

SCHEDULING_STATE

OBJECT

次で構成される OBJECT。

  • state (TEXT): スケジューリング状態（RUNNING または SUSPENDED）。

  • reason_code (TEXT): 状態が RUNNING はでない場合のオプションの理由。

  • reason_message (TEXT): 動的テーブルが実行されていない理由のテキストによる説明。状態が実行されていない場合にのみ適用されます。

  • suspended_on (TIMESTAMP_LTZ): 動的テーブルが中断された時のオプションのタイムスタンプ。

  • resumed_on (TIMESTAMP_LTZ): 動的テーブルが RUNNING の場合で、最後に再開されたときのオプションのタイムスタンプ。

使用上の注意

  • Information Schemaテーブル関数を呼び出す場合、セッションには使用中の INFORMATION_SCHEMA スキーマ または 完全修飾の関数名が必要です。詳細については、 Snowflake Information Schema をご参照ください。

言語: 日本語