ALTER BACKUP SET¶

バックアップセットのプロパティを変更します。この操作は、次のいずれかになります。

バックアップセットの一部になる新しいバックアップを取得します。
バックアップセットから古いバックアップを削除します。
バックアップポリシーで指定したスケジュールされたバックアップおよびスケジュールされたバックアップの削除を一時停止または再開します。
まだポリシーを持たないバックアップセットにバックアップポリシーを適用します。
バックアップセット内の特定のバックアップに対する法的保持の追加または削除をします。
バックアップセットの名前を変更します。
バックアップセットのコメントの指定または削除をします。

こちらもご参照ください。: CREATE BACKUP SET、 DROP BACKUP SET、 SHOW BACKUP SETS

構文¶

ALTER BACKUP SET <name> ADD BACKUP

ALTER BACKUP SET <name> APPLY BACKUP POLICY <policy_name> [ FORCE ]

ALTER BACKUP SET <name> SUSPEND BACKUP [ { CREATION | EXPIRATION } ] POLICY

ALTER BACKUP SET <name> RESUME BACKUP [ { CREATION | EXPIRATION } ] POLICY

ALTER BACKUP SET <name> DELETE BACKUP IDENTIFIER '<backup_id>'

ALTER BACKUP SET <name> MODIFY BACKUP IDENTIFIER '<backup_id>' { ADD | REMOVE } LEGAL HOLD

ALTER BACKUP SET <name> RENAME TO <new_name>

ALTER BACKUP SET <name> SET COMMENT = '<string_literal>'

ALTER BACKUP SET <name> UNSET COMMENT

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

ALTER BACKUP SET <name> UNSET TAG <tag_name> [ , <tag_name> ... ]

パラメーター¶

name

バックアップセットの識別子を指定します。

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

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

ADD BACKUP

セットに手動でバックアップを作成します。バックアップポリシーに新しいバックアップを取得するスケジュールが含まれていない場合は、これがバックアップセットに含まれるテーブル、スキーマ、またはデータベースの新しいバックアップを作成する方法です。また、バックアップが定期的にスケジュールで発生した場合でも、バックアップセットにいつでも新しいバックアップを作成することもできます。

APPLY BACKUP POLICY policy_name [ FORCE ]

バックアップセットに添付するバックアップポリシーを指定します。

FORCE オプションは、バックアップセットの既存のポリシーを上書きします。このオプションは、古いポリシーに保持ロックがない場合にのみ使用できます。

重要

保持ロック付きのバックアップポリシーをバックアップセットに適用すると、 元に戻せません 。規制コンプライアンスに必要な強力な保証により、バックアップセットに保持ロックを設定すると、ロックを取り消すことはできません。Snowflakeサポートもそのような保持ロックを取り消すことはできません。削除できないバックアップセットとそれを含むスキーマとデータベースの予期しないストレージ料金を回避するために、長い有効期間のバックアップセットに保持ロックを設定する前には慎重に計画してください。

Snowflake組織が削除された場合、その組織はSnowflakeカスタマーではなくなります。この場合、Snowflakeは保持ロック付きのバックアップを含むすべてのバックアップを削除します。Snowflake組織を削除するには、Snowflakeサポートの関与が必要です。これは、管理者が誤って実行できるものではありません。

SUSPEND BACKUP [ { CREATION | EXPIRATION } ] POLICY

バックアップセットのバックアップポリシーを一時停止します。バックアップポリシー全体を、または作成または期限切れの操作のみを一時停止できます。SUSPEND BACKUP POLICY を CREATION または EXPIRATION キーワードなしで指定した場合、Snowflakeはポリシーの作成と期限切れの要素の両方を一時停止します。詳細については、バックアップセットのバックアップポリシーを一時停止するをご参照ください。

RESUME BACKUP [ { CREATION | EXPIRATION } ] POLICY

セットで一時停止されたバックアップポリシーを再開します。バックアップポリシー全体を、または作成または期限切れの操作のみを再開できます。RESUME BACKUP POLICY を CREATION または EXPIRATION キーワードなしで指定した場合、Snowflakeはポリシーの作成と期限切れの要素の両方を再開します。詳細については、バックアップセットのバックアップポリシーを再開するをご参照ください。

DELETE BACKUP IDENTIFIER 'backup_id'

バックアップセットのバックアップを ID で削除します。バックアップ ID は、 UUID_STRING 関数によって返される形式の UUID 値です。Snowflakeでは、バックアップセットから最も古いバックアップのみを削除できます。詳細については、バックアップセットからバックアップを削除するをご参照ください。

MODIFY BACKUP IDENTIFIER 'backup_id' { ADD | REMOVE } LEGAL HOLD

バックアップセット内の指定されたバックアップに法的保持を追加または削除します。WORM バックアップの法的保持に関する詳細については、法的保持をご参照ください。この句の使用例については、 :ref:`label-adding_removing_backup_legal_hold`をご参照ください。

RENAME TO new_name

バックアップセットの新しい識別子を指定します。アカウントに対して一意である必要があります。

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

SET COMMENT = 'string_literal'

バックアップセットにコメントを関連付けます。

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

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

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

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

UNSET ...

バックアップセットの設定を解除する1つ（または複数）のプロパティおよび/またはパラメーターを指定します。これにより、デフォルトにリセットされます。

property_name
param_name
- COMMENT
- TAG tag_name [ , tag_name ... ]

単一の ALTER ステートメントで複数のプロパティ/パラメーターをリセットできます。ただし、各プロパティ/パラメーターはコンマで区切る必要があります。また、プロパティ/パラメーターをリセットするときは、名前のみを指定します。値は必要ありません。

アクセス制御の要件¶

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


権限	説明
OWNERSHIP	バックアップセットの変更に使用されるロールには、バックアップセットに対する OWNERSHIP 権限が必要です。
APPLY BACKUP RETENTION LOCK	バックアップポリシーに保持ロックが含まれている場合、バックアップセットの所有者ロールは、アカウントに対してこの権限を持っている必要があります。
APPLY LEGAL HOLD	このアカウント権限は、バックアップから法的保持を追加または削除する機能を付与します。この権限は、 ADDLEGALHOLD および REMOVELEGALHOLD 句のみ必要です。デフォルトでは、 ACCOUNTADMIN ロールにこの権限があります。
APPLY	バックアップセットの所有者ロールは、直接またはロール階層を通じて、バックアップポリシーに対するこの権限を持っている必要があります。

バックアップポリシーのAPPLYおよびアカウントのAPPLY BACKUP RETENTION LOCKは、ロール階層の継承を通じて直接または間接的に、バックアップセットの所有者ロール（つまり、バックアップセットのOWNERSHIPを保持するロール）に付与されている必要があります。バックグラウンドでのスナップショット作成ジョブはバックアップセットの所有者ロールで実行されるため、ポリシー適用後は、バックアップセットの所有者ロールが当該ポリシーを使用できなければなりません。

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

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

使用上の注意¶

メタデータについて:

注意

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

重要

バックアップポリシーに保持ロックが適用されており、バックアップセットに有効期限が切れていないバックアップがある場合は、バックアップセットを削除できません。その場合は、セット内のすべてのバックアップの有効期限が切れるのを待つ必要があります。この制限は、 ACCOUNTADMINなどの権限ロールにも適用され、Snowflakeをサポートします。そのため、バックアップポリシーで保持ロックと長期の有効期限を指定する場合は注意してください。

例¶

バックアップセット t1_backups にバックアップを手動で追加します。

ALTER BACKUP SET t1_backups
  ADD BACKUP;

バックアップセット t1_backups のバックアップポリシーを更新します。

ALTER BACKUP SET t1_backups
  APPLY BACKUP POLICY daily_backup_policy;

バックアップセット t1_backup のバックアップポリシーを一時停止します。

ALTER BACKUP SET t1_backups
  SUSPEND BACKUP POLICY;

バックアップセット t1_backups のバックアップポリシーを再開します。

ALTER BACKUP SET t1_backups
  RESUME BACKUP POLICY;

バックアップセットの名前を``t1_backups``から``table1_backups``に変更します。

ALTER BACKUP SET t1_backups
  RENAME TO table1_backups;

ADD LEGAL HOLD および REMOVE LEGAL HOLD 句を持つバックアップ識別子を見つけるには、通常、SHOW BACKUPS コマンドを使用して対象となるバックアップとその作成時間をリストします。次の例は、適切なバックアップをリストし、1つの特定のバックアップにリーガルホールドを追加し、後でその法的保持を削除する方法を示しています。自分のロール名、バックアップセット名、バックアップ識別子を置き換えます。

USE ROLE my_legal_hold_role; -- use a role that has the APPLY LEGAL HOLD privilege
SHOW BACKUPS IN BACKUP SET my_db_backup_set
  ->> SELECT "created_on", "backup_id" FROM $1 WHERE "is_under_legal_hold" = 'N';
ALTER BACKUP SET my_db_backup_set
  MODIFY BACKUP IDENTIFIER '790d1ee4-88b2-451f-9ccc-eacd1e93a134'
  ADD LEGAL HOLD;

USE ROLE my_legal_hold_role; -- use a role that has the APPLY LEGAL HOLD privilege
SHOW BACKUPS IN BACKUP SET my_db_backup_set
  ->> SELECT "created_on", "backup_id" FROM $1 WHERE "is_under_legal_hold" = 'Y';
ALTER BACKUP SET my_db_backup_set
  MODIFY BACKUP IDENTIFIER '790d1ee4-88b2-451f-9ccc-eacd1e93a134'
  REMOVE LEGAL HOLD;