ALTER DYNAMIC TABLE

動的テーブル のプロパティを変更します。

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

CREATE DYNAMIC TABLEDESCRIBE DYNAMIC TABLEDROP DYNAMIC TABLESHOW DYNAMIC TABLES

このトピックの内容:

構文

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> ]
Copy

パラメーター

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 を開き、 Monitoring » Dynamic Tables を選択します。

    • DYNAMIC_TABLE_GRAPH_HISTORY テーブル関数を呼び出し、結果を調べます。

  • メタデータについて、

    注意

    Snowflakeサービスを使用する場合、お客様は、個人データ(ユーザーオブジェクト向け以外)、機密データ、輸出管理データ、またはその他の規制されたデータがメタデータとして入力されていないことを確認する必要があります。詳細については、 Snowflakeのメタデータフィールド をご参照ください。

product という動的テーブルのラグタイムを1時間に変更します。

ALTER DYNAMIC TABLE product SET
  TARGET_LAG = '1 hour';
Copy