カテゴリ:

Information Schemaテーブル関数

DYNAMIC_TABLE_GRAPH_HISTORY

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

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

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

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

構文

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

引数

引数はすべてオプションです。引数がない場合は、現在存在するダイナミックテーブルの最新の説明のみが返されます。 TIMESTAMP_LTZ 形式constant_expr を指定します。

AS_OF => constant_expr

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

HISTORY_START => constant_expr. HISTORY_END => constant_expr

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

出力

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

これらの列を表示するには、 MONITOR 権限を持つロールを使用する必要があります。それ以外の場合、関数は NAMESCHEMA_NAMEDATABASE_NAMEQUALIFIED_NAME の値のみを返します。動的テーブル権限の詳細については、 動的テーブルのメタデータを表示する権限 をご参照ください。

列名

データ型

説明

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

次のいずれかです。

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): スケジューリング状態(ACTIVE または SUSPENDED)。

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

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

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

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

ALTER_TRIGGER

ARRAY

DYNAMIC_TABLE_GRAPH_HISTORY 関数で新しいエントリが作成される理由を説明します。次のいずれかになります。

  • NONE (下位互換性あり)

  • CREATE_DYNAMIC_TABLE

  • ALTER_TARGET_LAG

  • SUSPEND

  • RESUME

  • REPLICATION_REFRESH

  • ALTER_WAREHOUSE

使用上の注意

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

アカウント内の各動的テーブルのグラフ履歴、そのプロパティ、および他のテーブルや動的テーブルへの依存関係を取得します。

SELECT
  name,
  inputs,
  target_lag_type,
  target_lag_sec,
  scheduling_state,
  alter_trigger
FROM
  TABLE (
    INFORMATION_SCHEMA.DYNAMIC_TABLE_GRAPH_HISTORY ()
  )
ORDER BY
  name;
Copy
+--------------------+---------------------------------------------------+-----------------+----------------+---------------------------------------------+------------------+
| NAME               |[] INPUTS                                          | TARGET_LAG_TYPE | TARGET_LAG_SEC | [] SCHEDULING_STATE                         | [] ALTER_TRIGGER |
|--------------------+---------------------------------------------------+-----------------+----------------+---------------------------------------------|------------------+
| MY_DYNAMIC_TABLE_1 | [                                                 | USER_DEFINED    | 300            | {                                           | [                |
|                    |  {                                                |                 |                |   "resumed_on": "2024-03-01 10:29:02.066 Z",|   "RESUME"       |
|                    |    "kind": "DYNAMIC_TABLE",                       |                 |                |   "state": "ACTIVE"                         | ]                |
|                    |    "name": "MY_QUALIFIED_NAME.MY_DYNAMIC_TABLE_2" |                 |                | }                                           |                  |
|                    |  }                                                |                 |                |                                             |                  |
|                    | ]                                                 |                 |                |                                             |                  |
+--------------------+---------------------------------------------------+-----------------+----------------+---------------------------------------------+------------------+