スキーマ：

ACCOUNT_USAGE

DYNAMIC_TABLE_REFRESH_HISTORY ビュー

このAccount Usageビューには、動的テーブル更新履歴の情報が表示されます。

こちらもご参照ください。

DYNAMIC_TABLE_REFRESH_HISTORY （情報スキーマ）

列

列名

データ型

説明

NAME

VARCHAR

動的テーブルの名前。

SCHEMA_NAME

VARCHAR

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

DATABASE_NAME

VARCHAR

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

ID

NUMBER

Snowflakeが生成する動的テーブルの内部識別子。

SCHEMA_ID

NUMBER

Snowflakeが生成する、動的テーブルを含むスキーマの内部識別子。

DATABASE_ID

NUMBER

Snowflakeが生成する、動的テーブルを含むデータベースの内部識別子。

STATE

VARCHAR

動的テーブルのリフレッシュのステータス。以下のいずれかでになります: . - EXECUTING: 更新中。 . - SUCCEEDED: 更新完了。 . - FAILED: 更新実行中に失敗。 . - CANCELLED: 更新が実行前にキャンセルされた。 . - UPSTREAM_FAILED: 上流での更新失敗のため更新が実行されなかった。

STATE_CODE

VARCHAR

リフレッシュの現行状態を表すコード。

STATE_MESSAGE

VARCHAR

リフレッシュの現行状態の説明。

QUERY_ID

VARCHAR

動的テーブルの結果を生成した SQL ステートメントの ID。

DATA_TIMESTAMP

TIMESTAMP_LTZ

リフレッシュが評価されたトランザクションのタイムスタンプ。（実際のリフレッシュの時間より少し前になる可能性があります。）このタイムスタンプより前に到着した、ベースオブジェクト内のすべてのデータが、現在動的テーブルに含まれています。

REFRESH_START_TIME

TIMESTAMP_LTZ

リフレッシュジョブの開始時刻。

REFRESH_END_TIME

TIMESTAMP_LTZ

リフレッシュの完了時刻。

COMPLETION_TARGET

TIMESTAMP_LTZ

動的テーブルのラグを TARGET_LAG パラメーター以下に維持するためにこのリフレッシュを完了する必要がある時刻。これは最後のリフレッシュの DATA_TIMESTAMP + TARGET_LAG に等しくなります。

QUALIFIED_NAME

TEXT

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

LAST_COMPLETED_DEPENDENCY

OBJECT

次のプロパティを含みます: . - qualified_name: 使用可能になる最新の依存関係の修飾名。 . - data_timestamp: その依存関係の更新バージョン。

STATISTICS

OBJECT

次のプロパティを含みます: . - numInsertedRows: 挿入された行の数。 . - numDeletedRows: 削除された行の数。 . - numCopiedRows: 変更されずにコピーされた行の数。 . - numAddedPartitions: 追加されたパーティションの数。 . - numRemovedPartitions: 削除されたパーティションの数。 . 例: UPDATE ステートメントにより10行のパーティションのうち1行が更新された場合。すると、上記のメトリックは、1行が挿入され、1行が削除され、9行がコピーされたことを示します。さらに、1つのパーティションが削除され、1つのパーティションが追加されます。

REFRESH_ACTION

TEXT

次のいずれか： . - NO_DATA - ベーステーブルに新しいデータがない。ベース・テーブルにデータがあるかどうかに関係なく、新しく作成された動的テーブルの最初の更新には適用されない。 . - REINITIALIZE - ベーステーブルが変更されたか、クローンされた動的テーブルのソーステーブルがクローン中に更新された。 . - FULL - 動的テーブルにインクリメンタル更新されないクエリ要素が含まれているため(SHOW DYNAMIC TABLE refresh_mode_reasonを参照)、または、インクリメンタル更新よりも安価であるため、完全更新が行われた。 . - INCREMENTAL - 通常のインクリメンタル更新。

REFRESH_TRIGGER

TEXT

以下のいずれか: . - SCHEDULED - ターゲットラグまたは下流ターゲットラグを満たすための通常のバックグラウンド更新。 . - MANUAL - ユーザーまたはタスクで使用される ALTER DYNAMIC TABLE <名前> REFRESH。 . - CREATION - 動的テーブルまたはコンシューマ動的テーブルの作成でトリガーされ、作成 DDL ステートメント中に実行される更新。

TARGET_LAG

TEXT

この列は、リフレッシュが発生した時点の動的テーブルのターゲットラグ値を説明します。

GRAPH_HISTORY_VALID_FROM

TIMESTAMP_NTZ

特定のリフレッシュが動的テーブルのどのバージョンに対応するかを明確にするために、リフレッシュが発生した DYNAMIC_TABLE_GRAPH_HISTORY テーブル関数の VALID_FROM タイムスタンプをエンコードします。対応する動的テーブルが作成されていないと、この値が NULL になる場合もあります。

使用上の注意

  • ビューの待機時間は最大3時間です。

  • このビューをクエリするには、 SNOWFLAKE.USAGE_VIEWER データベースロール を付与するロールを使用します。

例

過去1週間に失敗した動的テーブルの更新を検索します。

SELECT
    data_timestamp,
    database_name,
    schema_name,
    name,
    state,
    state_message,
    query_id
  FROM snowflake.account_usage.dynamic_table_refresh_history
  WHERE state = 'FAILED' AND data_timestamp >= dateadd(WEEK, -1, current_date())
  ORDER BY data_timestamp DESC
  LIMIT 10;
Copy
言語: 日本語