ALTER SNAPSHOT SET --- Deprecated¶

構文¶

ALTER SNAPSHOT SET <name> ADD SNAPSHOT

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

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

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

ALTER SNAPSHOT SET <name> DELETE SNAPSHOT IDENTIFIER '<snapshot_id>'

ALTER SNAPSHOT SET <name> MODIFY SNAPSHOT IDENTIFIER '<snapshot_id>' { ADD | REMOVE } LEGAL HOLD

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

ALTER SNAPSHOT SET <name> UNSET COMMENT

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

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

パラメーター¶

name

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

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

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

ADD SNAPSHOT

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

APPLY SNAPSHOT POLICY policy_name [ FORCE ]

スナップショットセットに添付するスナップショットポリシーを指定します。

The FORCE option overwrites an existing policy on a snapshot set. You can only use this option if the old policy doesn't have a retention lock.

重要

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

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

SUSPEND SNAPSHOT [ { CREATION | EXPIRATION } ] POLICY

Suspend a snapshot policy in the snapshot set. You can suspend the entire snapshot policy, or only creation or expiration operations. When you specify SUSPEND SNAPSHOT POLICY without the CREATION or EXPIRATION keywords, Snowflake suspends both the creation and expiration aspects of the policy. For more information, see Suspend a backup policy on a backup set.

RESUME SNAPSHOT [ { CREATION | EXPIRATION } ] POLICY

Resume a suspended snapshot policy in the set. You can resume the entire snapshot policy, or only creation or expiration operations. When you specify RESUME SNAPSHOT POLICY without the CREATION or EXPIRATION keywords, Snowflake resumes both the creation and expiration aspects of the policy. For more information, see Resume a backup policy on a backup set.

DELETE SNAPSHOT IDENTIFIER 'snapshot_id'

Delete a snapshot in the snapshot set by ID. The snapshot ID is a UUID value, in the format returned by the UUID_STRING function. Snowflake only allows deleting the oldest snapshot from the snapshot set. For more information, see Delete a backup from a backup set.

MODIFY SNAPSHOT IDENTIFIER 'snapshot_id' { ADD | REMOVE } LEGAL HOLD

スナップショットセット内の指定されたスナップショットにリーガルホールドを追加または削除します。WORM スナップショットのリーガルホールドに関する詳細については 、:ref:`label-snapshots_concept_legal_hold`をご参照ください。この句の使用例については、:ref:`label-adding_removing_snapshot_legal_hold`をご参照ください。

SET COMMENT = 'string_literal'

スナップショットセットにコメントを関連付けます。

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 ...

Specifies one (or more) properties and/or parameters to unset for the snapshot set, which resets them to the defaults:

• property_name

• param_name

  • COMMENT

  • TAG tag_name [ , tag_name ... ]

You can reset multiple properties/parameters with a single ALTER statement; however, each property/parameter must be separated by a comma. Also, when resetting a property/parameter, you only specify the name; no value is required.

アクセス制御の要件¶

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

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

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

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

使用上の注意¶

• メタデータについて:

  注意

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

例¶

スナップショットセットにスナップショットを手動で追加する t1_snapshots:

ALTER SNAPSHOT SET t1_snapshots
  ADD SNAPSHOT;

スナップショットセットのスナップショットポリシーを更新する t1_snapshots:

ALTER SNAPSHOT SET t1_snapshots
  APPLY SNAPSHOT POLICY daily_snapshot_policy;

スナップショットセットのスナップショットポリシーを一時停止する t1_snapshot:

ALTER SNAPSHOT SET t1_snapshots
  SUSPEND SNAPSHOT POLICY;

スナップショットセットのスナップショットポリシーを再開する t1_snapshots:

ALTER SNAPSHOT SET t1_snapshots
  RESUME SNAPSHOT POLICY;

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

USE ROLE my_legal_hold_role; -- use a role that has the APPLY LEGAL HOLD privilege
SHOW SNAPSHOTS IN SNAPSHOT SET my_db_snapshot_set
  ->> SELECT "created_on", "snapshot_id" FROM $1 WHERE "is_under_legal_hold" = 'N';
ALTER SNAPSHOT SET my_db_snapshot_set
  MODIFY SNAPSHOT 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 SNAPSHOTS IN SNAPSHOT SET my_db_snapshot_set
  ->> SELECT "created_on", "snapshot_id" FROM $1 WHERE "is_under_legal_hold" = 'Y';
ALTER SNAPSHOT SET my_db_snapshot_set
  MODIFY SNAPSHOT IDENTIFIER '790d1ee4-88b2-451f-9ccc-eacd1e93a134'
  REMOVE LEGAL HOLD;