動的テーブル: 戻り値の変更および DYNAMIC_TABLE_GRAPH_HISTORY、 DYNAMIC_TABLE_REFRESH_HISTORY、 SHOW DYNAMIC TABLES への新しい列の追加（保留中）¶

注意

この動作変更は2024_02バンドルにあります。

バンドルの現在のステータスについては、バンドル履歴をご参照ください。

戻り値の動作¶

DYNAMIC_TABLE_GRAPH_HISTORY、 DYNAMIC_TABLE_REFRESH_HISTORY、および SHOWDYNAMICTABLES 関数の動作が変更されました。これらの関数の戻り値は以下のように表示されます。

この動作変更バンドルが有効な場合は、 DYNAMIC_TABLE_GRAPH_HISTORY 関数の出力に以下のような戻り値の変更が含まれます。

変更前:

SCHEDULING_STATE 列は、 "state": "RUNNING" または "state": "SUSPENDED" を返して、動的テーブルの状態を説明します。
SCHEDULING_STATE 列は、上流のテーブルが中断され、その上流のテーブルで MONITOR 権限がない場合に RUNNING を返します。

変更後:

SCHEDULING_STATE 列は、 "state": "ACTIVE" または "state": "SUSPENDED" を返して、動的テーブルの状態を説明します。
SCHEDULING_STATE 列は、上流のテーブルで MONITOR 権限を持っていなくても SUSPENDED を返します。

この動作変更バンドルが有効な場合は、 DYNAMIC_TABLE_REFRESH_HISTORY 関数の出力に以下のような戻り値の変更が含まれます。

変更前:

変更後:

LAST_COMPLETED_DEPENDENCY 列が正確な値を返すようになりました。
上流での失敗によりスキップされたリフレッシュジョブに対して、 STATE 列は UPSTREAM_FAILED を返すようになりました。
STATE 列が QUEUED または SKIPPED を返す場合は、リフレッシュ履歴が表示されなくなりました。（動的テーブルのリフレッシュが上流での失敗によりスキップされた場合、 STATE 列は代わりに UPSTREAM_FAILED を返します）。

この動作変更バンドルが有効な場合は、 SHOW DYNAMIC TABLES コマンドの出力に以下のような戻り値の変更が含まれます。

変更前:

変更後:

有効にすると、 DYNAMIC_TABLE_GRAPH_HISTORY と DYNAMIC_TABLE_REFRESH_HISTORY 関数に以下の列が追加されます。

この動作変更バンドルが有効になっている場合は、 DYNAMIC_TABLE_GRAPH_HISTORY 関数の出力に以下の新しい列が含まれます。

列名	データ型	説明
ALTER_TRIGGER	ARRAY	DYNAMIC_TABLE_GRAPH_HISTORY 関数で新しいエントリが作成される理由を説明します。次のいずれかになります。 NONE （下位互換性あり） CREATE_DYNAMIC_TABLE ALTER_TARGET_LAG SUSPEND RESUME REPLICATION_REFRESH ALTER_WAREHOUSE

列名

データ型

説明

ALTER_TRIGGER

ARRAY

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

この動作変更バンドルが有効になっている場合は、 DYNAMIC_TABLE_REFRESH_HISTORY 関数の出力に以下の新しい列が含まれます。

列名	データ型	説明
TARGET_LAG	TEXT	この列は、リフレッシュが発生した時点の動的テーブルの TARGET_LAG 値を説明します。
GRAPH_HISTORY_VALID_FROM	TIMESTAMP_NTZ	リフレッシュ発生時の DYNAMIC_TABLE_GRAPH_HISTORY テーブル関数の VALID_FROM タイムスタンプをエンコードします。

参照: 1543