ALTER BACKUP SET

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

  • バックアップセットの一部になる新しいバックアップを取得します。

  • バックアップセットから古いバックアップを削除します。

  • バックアップポリシーで指定したスケジュールされたバックアップおよびスケジュールされたバックアップの削除を一時停止または再開します。

  • まだポリシーを持たないバックアップセットにバックアップポリシーを適用します。

  • バックアップセット内の特定のバックアップに対する法的保持の追加または削除をします。

  • Renaming the 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> ... ]
Copy

パラメーター

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

Specifies a new identifier for the backup set; must be unique for your account.

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

SET COMMENT = 'string_literal'

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

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

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

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

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

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 BACKUP POLICY 句で ALTER BACKUP SET コマンドを使用し、 既に存在するバックアップセットにバックアップポリシーを追加します。

これらの権限は、セカンダリロールではなく、現在アクティブなプライマリロールに対して必要です。

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

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

使用上の注意

  • メタデータについて:

    注意

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

重要

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

例

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

ALTER BACKUP SET t1_backups
  ADD BACKUP;
Copy

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

ALTER BACKUP SET t1_backups
  APPLY BACKUP POLICY daily_backup_policy;
Copy

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

ALTER BACKUP SET t1_backups
  SUSPEND BACKUP POLICY;
Copy

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

ALTER BACKUP SET t1_backups
  RESUME BACKUP POLICY;
Copy

Rename the backup set t1_backups to table1_backups:

ALTER BACKUP SET t1_backups
  RENAME TO table1_backups;
Copy

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;
Copy
言語: 日本語