ALTER SNAPSHOT POLICY --- Deprecated¶

Modifies the properties of a snapshot policy. The following changes are supported:

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

こちらもご参照ください。: CREATE SNAPSHOT POLICY --- Deprecated、 DROP SNAPSHOT POLICY --- Deprecated、 SHOW SNAPSHOT POLICIES --- Deprecated

構文¶

ALTER SNAPSHOT POLICY <name> RENAME TO <new_name>

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

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

ALTER SNAPSHOT POLICY <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER SNAPSHOT POLICY <name> UNSET TAG <tag_name> [ , <tag_name> ... ]

Copy

パラメーター¶

name

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

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

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

RENAME TO new_name

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

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

SET...

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

COMMENT = 'string_literal'

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

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

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

注釈

The minimum schedule for snapshots is 60 minutes or 1 hour.

すべてのポリシーには 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 構文もサポートしています。
num HOUR or num HOURS
Specifies an interval (in hours) of wait time between backups. Accepts positive integers only.

Also supports num H syntax.

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

When the object is created (using CREATE BACKUP SET ... WITH BACKUP POLICY).
When a different interval is set (using ALTER BACKUP SET ... APPLY BACKUP POLICY or ALTER BACKUP POLICY ... SET SCHEDULE).

The base interval time starts the interval counter from the current clock time. For example, if an INTERVAL value of 10 MINUTES is set and the scheduled backup is enabled at 9:03 AM, then the next backup is created at 9:13 AM, 9:23 AM, and so on. Note that we make a best effort to ensure absolute precision, but only guarantee that a backup does not execute before the set interval occurs (that is, in the current example, the backup could first run at 9:14 AM, but will definitely not run at 9:12 AM).

EXPIRE_AFTER_DAYS = days_integer

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

最小値: 1

Maximum value: 3653 (roughly 10 years) if you don't specify the SCHEDULE clause.

注釈

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

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

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

Specifies the tag name and the tag string value.

The tag value is always a string, and the maximum number of characters for the tag value is 256.

For information about specifying tags in a statement, see Tag quotas.

UNSET...

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

COMMENT
TAG tag_name [ , tag_name ... ]
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