ALTER DYNAMIC TABLE¶
プレビュー機能 --- オープン
アカウントで利用可能です。
動的テーブル のプロパティを変更します。
このトピックの内容:
構文¶
ALTER DYNAMIC TABLE [ <name> ] { SUSPEND | RESUME }
ALTER DYNAMIC TABLE [ <name> ] REFRESH
ALTER DYNAMIC TABLE <name> SET
[ TARGET_LAG = { '<num> { seconds | minutes | hours | days }' | DOWNSTREAM } ]
[ WAREHOUSE = <warehouse_name> ]
パラメーター¶
name変更するテーブルの識別子。識別子にスペースまたは特殊文字が含まれる場合、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。
SUSPEND | RESUME動的テーブルで実行するアクションを指定します。
SUSPENDは、動的テーブルのリフレッシュを中断します。動的テーブルが他の動的テーブルで使用されている場合は、それらも中断されます。RESUMEは、動的テーブルのリフレッシュを再開します。再開操作は、手動で中断されていない、下流にあるすべての動的テーブルにカスケードします。
動的テーブルの状態の表示については、 使用上の注意 をご参照ください。
REFRESH動的テーブルを手動でリフレッシュすることを指定します。ユーザーが中断した動的テーブルも自動中断した動的テーブルも手動でリフレッシュできます。手動でリフレッシュされた動的テーブルは、リフレッシュアクティビティとして MANUAL を表示します。
動的テーブルの状態の表示については、 使用上の注意 をご参照ください。動的テーブルのリフレッシュステータスについては、 DYNAMIC_TABLE_REFRESH_HISTORY の REFRESH_TRIGGER 列をご参照ください。
SET ...テーブルに設定する1つ以上のプロパティ/パラメーターを指定します（空白、コンマ、または改行で区切られます）。
TARGET_LAG = { num { seconds | minutes | hours | days } | DOWNSTREAM }動的テーブルのラグを指定します。
'num seconds | minutes | hours | days'動的テーブルのコンテンツがベーステーブルの更新から遅れる最大時間を指定します。
例:
動的テーブルのデータが5分以上遅れないようにするには、
5 minutesを指定します。動的テーブルのデータが5時間以上遅れないようにするには、
5 hoursを指定します。
最小値は1分です。動的テーブルAが別の動的テーブルBに依存している場合、Aの最小ラグはBのラグ以上にする必要があります。
DOWNSTREAM下流の祖先がリフレッシュされた場合に、動的テーブルがリフレッシュされるように指定します。
WAREHOUSE = warehouse_name動的テーブルをリフレッシュするためのコンピューティングリソースを提供するウェアハウスの名前を指定します。
動的テーブルを作成するには、このウェアハウスに対する USAGE 権限が必要です。
使用上の注意¶
動的テーブルを変更するには、テーブルに対する OPERATE 権限を持つロールを使用する必要があります。
既存の動的テーブルを更新し、現在の定義を確認する必要がある場合は、 GET_DDL 関数を呼び出します。
動的テーブルの状態のリストについては、 動的テーブルの状態 をご参照ください。
動的テーブル情報を表示するには、以下の方法があります。
Snowsight を開き、 Activity » Dynamic Tables を選択します。
DYNAMIC_TABLE_GRAPH_HISTORY テーブル関数を呼び出し、結果を調べます。
メタデータについて、
注意
Snowflakeサービスを使用する場合、お客様は、個人データ（ユーザーオブジェクト向け以外）、機密データ、輸出管理データ、またはその他の規制されたデータがメタデータとして入力されていないことを確認する必要があります。詳細については、 Snowflakeのメタデータフィールド をご参照ください。