ALTER BACKUP POLICY

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

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

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

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

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

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

CREATE BACKUP POLICY、 DROP BACKUP POLICY、 SHOW BACKUP POLICIES

構文

ALTER BACKUP POLICY <name> RENAME TO <new_name>

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

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

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

ALTER BACKUP 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 }'

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

注釈

バックアップの最小スケジュールは60分、つまり1時間です。

すべてのポリシーには 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か月後）に実行されるようにスケジュールされては いません 。

    注釈

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

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

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

  • num MINUTE または num MINUTES

    バックアップ間の待機時間の間隔（分単位）を指定します。正の整数のみを受け入れます。

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

  • num HOUR または num HOURS

    バックアップ間の待機時間の間隔（時間単位）を指定します。正の整数のみを受け入れます。

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

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

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

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

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

EXPIRE_AFTER_DAYS = days_integer

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

  • 最小値: 1

  • 最大値: SCHEDULE 句を指定しない場合は、 ``3653``（約10年）。

注釈

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

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

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

タグ の名前とタグ文字列の値を指定します。

タグ値は常に文字列であり、タグ値の最大文字数は256です。

ステートメントでのタグの指定に関する情報については、 Tag quotas をご参照ください。

UNSET...

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

  • COMMENT

  • TAG tag_name [ , tag_name ... ]

  • SCHEDULE

  • EXPIRE_AFTER_DAYS

注釈

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

アクセス制御の要件

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

権限

メモ

OWNERSHIP

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

APPLY BACKUP RETENTION LOCK

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

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

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

使用上の注意

メタデータについて:

注意

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

例

Rename the backup policy hourly_backup_policy to daily_backup_policy:

ALTER BACKUP POLICY hourly_backup_policy
  RENAME TO daily_backup_policy;
Copy

バックアップポリシー hourly_backup_policy にコメントを追加します。

ALTER BACKUP POLICY hourly_backup_policy
  SET COMMENT = 'hourly backup expires in 90 days';
Copy

バックアップポリシー every_two_hours のスケジュールを変更します。

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

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

ALTER BACKUP POLICY sample_backup_policy UNSET EXPIRE_AFTER_DAYS;
Copy
言語: 日本語