ALTER SNAPSHOT POLICY

スナップショット ポリシーのプロパティを変更します。次の変更がサポートされています。

  • ポリシーの名前を変更する。

  • ポリシーのコメントを追加または更新する。

  • ポリシーのスケジュールと有効期限の設定を変更する。スケジュールでは、Snowflakeが自動的にバックアップを作成し、結果のスナップショットをポリシーが管理するスナップショットセットに追加する頻度を決定します。有効期限は、関連付けされたスナップショットセットからSnowflakeが自動的にスナップショットを削除するまでの各スナップショットの保持期間を決定します。

  • ポリシーのプロパティ設定を解除し、デフォルト値に戻す。

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

CREATE SNAPSHOT POLICY、 DROP SNAPSHOT POLICY、 SHOW SNAPSHOT POLICIES

構文

ALTER SNAPSHOT POLICY <name> RENAME TO <new_name>

ALTER SNAPSHOT POLICY <name> SET
  [ COMMENT = '<string_literal>' ]
  [ SCHEDULE = '{ <num> MINUTE | USING CRON <expr> <time_zone> }' ]
  [ EXPIRE_AFTER_DAYS = <days_integer> ]

ALTER SNAPSHOT POLICY <name> UNSET { COMMENT | SCHEDULE | EXPIRE_AFTER_DAYS }
Copy

パラメーター

name

スナップショットポリシーの識別子を指定します。

識別子にスペースまたは特殊文字が含まれる場合は、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

詳細については、 識別子の要件 をご参照ください。

RENAME TO new_name

スナップショットポリシーの新しい識別子を指定します。アカウントに対して一意である必要があります。

詳細については、 識別子の要件 をご参照ください。

SET...

スナップショットポリシーに設定する1つ以上のプロパティを指定します（空白、コンマ、または改行で区切り）。

COMMENT = 'string_literal'

スナップショットポリシーのコメントを指定します。

SCHEDULE = '{ num MINUTE | USING CRON expr time_zone }'

オブジェクトのスナップショットを作成するためのスケジュールを指定します。

注釈

スナップショットの最短スケジュールは60分です。

すべてのポリシーには SCHEDULE 句、 EXPIRE_AFTER_DAYS 句、またはその両方が含まれている必要があります。

  • USING CRON expr time_zone

    オブジェクトのスナップショットが作成された時点のcron式とタイムゾーンを指定します。標準のcronユーティリティ構文のサブセットをサポートします。

    タイムゾーンのリストについては、 tzデータベースタイムゾーンのリスト （Wikipedia）をご参照ください。

    cron式は、次のフィールドで構成されます。

    # __________ minute (0-59)
# | ________ hour (0-23)
# | | ______ day of month (1-31, or L)
# | | | ____ month (1-12, JAN-DEC)
# | | | | __ day of week (0-6, SUN-SAT, or L)
# | | | | |
# | | | | |
  * * * * *

    次の特殊文字がサポートされています。

    *

    ワイルドカード。フィールドのオカレンスを指定します。

    L

    「最後」の略。曜日フィールドで使用すると、特定の月の「最後の金曜日」（「5L」）などの構造を指定できます。月の日フィールドでは、月の最後の日を指定します。

    /n

    特定の時間単位の nth インスタンスを示します。時間の各クォンタムは独立して計算されます。たとえば、月フィールドに 4/3 が指定されている場合、スナップショットは4月、7月、および10月（つまり、1年の中で4番目の月から始まり、3か月ごと）にスケジュールされます。その後も同じスケジュールが維持されます。つまり、スナップショットは1月（10月の実行から3か月後）に実行されるようにスケジュールされては:emph:いません。

    注釈

    • cron式は現在、指定されたタイムゾーンに対してのみ評価します。アカウントの TIMEZONE パラメーター値を変更（またはユーザーレベルまたはセッションレベルで値を設定）しても、スナップショットのタイムゾーンは変更 されません。

    • cron式は、スナップショットのすべての 有効な 実行時間を定義します。Snowflakeはこのスケジュールに基づいてスナップショットの作成を試みますが、次の有効な実行時間が始まる前に前の実行が完了していない場合、有効な実行時間はスキップされます。

    • cron式に特定の月の日と曜日の両方が含まれている場合、スナップショットは月の日または曜日の いずれか を満たす日にスケジュールされます。たとえば、:samp:`SCHEDULE = 'USING CRON 0 0 10-20 * TUE,THU UTC'`は、月の10日から20日、およびそれらの日付以外の火曜日または木曜日の0AM（真夜中）にスナップショットをスケジュールします。

  • num MINUTE

    スナップショット間の待機時間の間隔（分単位）を指定します。正の整数のみを受け入れます。

    num M 構文もサポートしています。

    あいまいさを避けるために、次の状況では 基本間隔時間 が設定されます。

    • オブジェクトの作成時（CREATE SNAPSHOTSET...WITHSNAPSHOTPOLICYを使用）。

    • 異なる間隔が設定されている場合（ ALTERSNAPSHOT SET ... APPLY SNAPSHOT POLICYまたはALTERSNAPSHOTPOLICYSETSCHEDULE を使用）。

    基本間隔時間は、現在のクロックタイムから間隔カウンターを開始します。たとえば、 INTERVAL の 10 値が設定され、スケジュールされたスナップショット9:03 AM で有効になっている場合、次のスナップショットは9:13 AM、9:23 AM というように作成されます。絶対精度を確保するために最善を尽くしますが、保証されるのは、設定間隔の:emph:` 前に` スナップショットが実行されないようにすることのみです（つまり、現在の例では、スナップショットは最初に9:14AM に実行されることはあっても、9:12AMに実行されることは決してありません）。

EXPIRE_AFTER_DAYS = days_integer

スナップショットの有効期限が切れるまでの日数を指定します。Snowflakeは、期限切れのスナップショットを自動的に削除します。このパラメーターが指定されない場合、スナップショットはスナップショットセットから手動で削除されるまで、スナップショットセットに残ります。

注釈

ポリシーに保持ロックがある場合は、EXPIRE_AFTER_DAYS 値を増やすことができますが、その値を減らすことはできません。

すべてのポリシーには SCHEDULE 句、 EXPIRE_AFTER_DAYS 句、またはその両方が含まれている必要があります。

UNSET...

スナップショットポリシーの以下のいずれかのプロパティ設定を解除します。プロパティはデフォルト値に戻ります。

  • COMMENT

  • SCHEDULE

  • EXPIRE_AFTER_DAYS

注釈

SCHEDULE プロパティ、または EXPIRE_AFTER_DAYS プロパティの設定を解除することができますが、両方を解除することはできません。たとえば、新しいスナップショットを作成する予定がなく、既存のスナップショットを特定の時間に有効期限切れにする場合は、EXPIRE_AFTER_DAYSプロパティを保持出来る場合があります。

アクセス制御の要件

この操作の実行に使用される ロール には、少なくとも次の 権限 が必要です。

権限

メモ

OWNERSHIP

スナップショットポリシーの変更に使用されるロールには、スナップショットポリシーに対するOWNERSHIP 権限が必要です。

APPLY SNAPSHOT RETENTION LOCK

保持ロックを持つスナップショットポリシーの変更に使用されるロールには、アカウントに対するこの権限が必要です。

指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。

セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。

使用上の注意

メタデータについて:

注意

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

例

スナップショットポリシーにコメントを追加する``hourly_snapshot_policy``:

ALTER SNAPSHOT POLICY hourly_snapshot_policy
  SET COMMENT = 'hourly snapshot expires in 90 days';
Copy

スナップショットポリシーのスケジュールを変更する every_two_hours:

ALTER SNAPSHOT POLICY every_two_hours SET SCHEDULE = '120 MINUTE';
Copy

EXPIRE_AFTER_DAYS プロパティをデフォルト値に戻す:

ALTER SNAPSHOT POLICY sample_snapshot_policy UNSET EXPIRE_AFTER_DAYS;
Copy
言語: 日本語