ALTER SNAPSHOT SET — Deprecated¶

Modifies the properties for a snapshot set. This operation can be one of the following:

Erstellen eines neuen Backups, das Teil des Snapshot-Sets wird.
Entfernen eines alten Backups aus dem Snapshot-Set.
Anhalten oder Fortsetzen der geplanten Backups und der geplanten Löschung von Snapshots, die in der Snapshot-Richtlinie festgelegt sind.
Anwenden einer Snapshot-Richtlinie auf ein Snapshot-Set, das noch keine Richtlinie hat.
Hinzufügen oder Entfernen einer gesetzlichen Aufbewahrungsfrist für einen bestimmten Snapshot innerhalb des Snapshot-Sets.
Angeben oder Entfernen eines Kommentars zum Snapshot-Set.

Siehe auch:: CREATE SNAPSHOT SET — Deprecated, DROP SNAPSHOT SET — Deprecated, SHOW SNAPSHOT SETS — Deprecated

Syntax¶

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

Copy

Parameter¶

name

Gibt den Bezeichner für das Snapshot-Set an.

Wenn der Bezeichner Leerzeichen oder Sonderzeichen enthält, muss die gesamte Zeichenfolge in doppelte Anführungszeichen gesetzt werden. Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß- und Kleinschreibung zu beachten.

Weitere Informationen dazu finden Sie unter Anforderungen an Bezeichner.

ADD SNAPSHOT

Erstellen Sie manuell einen Snapshot im Set. Wenn die Snapshot-Richtlinie keinen Zeitplan für neue Backups enthält, erstellen Sie auf diese Weise ein neues Backup der Tabelle, des Schemas oder der Datenbank, die im Snapshot-Set enthalten sind. Sie können auch jederzeit neue Backups im Snapshot-Set erstellen, selbst wenn die Backups nach einem regelmäßigen Zeitplan erfolgen.

APPLY SNAPSHOT POLICY policy_name [ FORCE ]

Gibt die Snapshot-Richtlinie an, die mit dem Snapshot-Set verbunden werden soll.

Die FORCE-Option überschreibt eine bestehende Richtlinie für ein Snapshot-Set. Sie können diese Option nur verwenden, wenn die alte Richtlinie keine Aufbewahrungssperre hat.

Wichtig

Das Anwenden einer Snapshot-Richtlinie mit einer Aufbewahrungssperre auf einen Snapshot-Satz ist irreversibel. Aufgrund der starken Garantien, die für die Einhaltung gesetzlicher Vorschriften erforderlich sind, können Sie die Sperre nicht mehr widerrufen, nachdem Sie einem Snapshot-Set eine Aufbewahrungssperre erteilt haben. Der Snowflake-Support kann eine solche Aufbewahrungssperre auch nicht widerrufen. Planen Sie sorgfältig, bevor Sie eine Aufbewahrungssperre für ein Snapshot-Set mit einer langen Ablauffrist festlegen, um unerwartete Speichergebühren für nicht löschbare Snapshot-Sets und die Schemas und Datenbanken, die sie enthalten, zu vermeiden.

Wenn eine Snowflake-Organisation gelöscht wird, ist die Organisation nicht mehr ein Snowflake-Kunde. In diesem Fall löscht Snowflake alle Snapshots, auch solche mit Aufbewahrungssperren. Das Löschen einer Snowflake-Organisation erfordert die Einbeziehung des Snowflake-Supports. Das kann ein Administrator nicht versehentlich tun.

SUSPEND SNAPSHOT [ { CREATION | EXPIRATION } ] POLICY

Setzen Sie eine Snapshot-Richtlinie im Snapshot-Set aus. Sie können die gesamte Snapshot-Richtlinie oder nur die Erstellungs- oder Ablaufvorgänge aussetzen. Wenn Sie SUSPEND SNAPSHOT POLICY ohne die CREATION- oder EXPIRATION-Schlüsselwörter angeben, setzt Snowflake sowohl den Erstellungs- als auch den Ablaufvorgang der Richtlinie aus. Weitere Informationen dazu finden Sie unter Backup-Richtlinien für Backup-Sets aussetzen.

RESUME SNAPSHOT [ { CREATION | EXPIRATION } ] POLICY

Setzen Sie eine ausgesetzte Snapshot-Richtlinie im Set fort. Sie können die gesamte Snapshot-Richtlinie oder nur die Erstellungs- oder Ablaufvorgänge wieder aufnehmen. Wenn Sie RESUME SNAPSHOT POLICY ohne die CREATION- oder EXPIRATION-Schlüsselwörter angeben, nimmt Snowflake sowohl den Erstellungs- als auch den Ablaufvorgang der Richtlinie wieder auf. Weitere Informationen dazu finden Sie unter Backup-Richtlinien für Backup-Sets fortsetzen.

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 Backups aus Backup-Sets löschen.

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

Fügt einem bestimmten Snapshot innerhalb des Snapshot-Sets eine gesetzliche Aufbewahrungsfrist hinzu oder entfernt sie. Weitere Informationen zu gesetzlichen Aufbewahrungsfristen für WORM-Snapshots finden Sie unter Gesetzliche Aufbewahrungsfrist. Beispiele für die Verwendung dieser Klausel finden Sie unter Gesetzliche Aufbewahrungsfristen hinzufügen und entfernen.

SET COMMENT = 'string_literal'

Verknüpfen Sie Snapshot-Set mit einem Kommentar.

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

Gibt den Namen des Tags und den Wert der Tag-Zeichenfolge an.

Der Tag-Wert ist immer eine Zeichenfolge, die maximale 256 Zeichen lang sein kann.

Weitere Informationen zur Angabe von Tags in einer Anweisung finden Sie unter Tag quotas.

UNSET ...

Gibt eine (oder mehrere) Eigenschaften und/oder Parameter an, deren Einstellung für das Snapshot-Set wieder aufgehoben werden sollen, wodurch sie auf die Standardwerte zurückgesetzt werden:

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

Sie können mehrere Eigenschaften/Parameter mit einer einzigen ALTER-Anweisung zurücksetzen. Dabei müssen die einzelne Eigenschaften/Parameter aber durch ein Komma getrennt werden. Beim Zurücksetzen einer Eigenschaft/Parameter geben Sie nur den Namen an. Es wird kein Wert benötigt.

Anforderungen an die Zugriffssteuerung¶

Eine Rolle, die zur Ausführung dieser Operation verwendet wird, muss mindestens die folgenden Berechtigungen haben:

Berechtigung	Beschreibung
OWNERSHIP	Die Rolle, die zum Bearbeiten eines Snapshot-Sets verwendet wird, muss die OWNERSHIP-Berechtigung für das Snapshot-Set haben.
APPLY SNAPSHOT RETENTION LOCK	Wenn die auf ein Snapshot-Set angewendete Snapshot-Richtlinie eine Aufbewahrungssperre enthält, muss die Rolle, mit der die Richtlinie angewendet wird, diese Berechtigung für das Konto haben.
APPLY LEGAL HOLD	Diese Kontoberechtigung bietet die Möglichkeit, einem Snapshot eine gesetzliche Aufbewahrungsfrist hinzuzufügen oder zu entziehen. Diese Berechtigung wird nur für ADD LEGAL HOLD und REMOVE LEGAL HOLD-Klauseln benötigt. Standardmäßig verfügt die Rolle ACCOUNTADMIN über diese Berechtigung.
APPLY	Nur ein Benutzer mit dieser Berechtigung für die Snapshot-Richtlinie kann den ALTER SNAPSHOT SET-Befehl mit der APPLY SNAPSHOT POLICY-Klausel verwenden, um die Snapshot-Richtlinie zu einem bereits vorhandenen Snapshot-Set hinzuzufügen.

Diese Berechtigungen sind für die derzeit aktive Primärrolle erforderlich, nicht für eine Sekundärrolle.

Eine Anleitung zum Erstellen einer kundenspezifischen Rolle mit einer bestimmten Gruppe von Berechtigungen finden Sie unter Erstellen von kundenspezifischen Rollen.

Allgemeine Informationen zu Rollen und Berechtigungen zur Durchführung von SQL-Aktionen auf sicherungsfähigen Objekten finden Sie unter Übersicht zur Zugriffssteuerung.

Nutzungshinweise¶

Metadaten:

Achtung

Kunden müssen sicherstellen, dass bei der Nutzung des Snowflake-Dienstes keine personenbezogenen Daten (außer für ein Objekt „User“), sensible Daten, exportkontrollierte Daten oder andere regulierte Daten als Metadaten eingegeben werden. Weitere Informationen dazu finden Sie unter Metadatenfelder in Snowflake.

Wichtig

Wenn auf die Snapshot-Richtlinie eine Aufbewahrungssperre angewendet wurde und noch nicht abgelaufene Snapshots im Snapshot-Satz enthalten sind, können Sie den Snapshot-Satz nicht löschen. In diesem Fall müssen Sie warten, bis alle Snapshots im Satz abgelaufen sind. Diese Einschränkung gilt auch für privilegierte Rollen wie ACCOUNTADMINund für den Snowflake-Support. Aus diesem Grund sollten Sie vorsichtig sein, wenn Sie in einer Snapshot-Richtlinie eine Aufbewahrungssperre und einen langen Ablaufzeitpunkt angeben.

Beispiele¶

Fügen Sie manuell einen Snapshot zum Snapshot-Set t1_snapshots hinzu:

ALTER SNAPSHOT SET t1_snapshots
  ADD SNAPSHOT;

Copy

Aktualisieren Sie die Snapshot-Richtlinie für das Snapshot-Set t1_snapshots:

ALTER SNAPSHOT SET t1_snapshots
  APPLY SNAPSHOT POLICY daily_snapshot_policy;

Copy

Setzen Sie eine Snapshot-Richtlinie für das Snapshot-Set t1_snapshot aus:

ALTER SNAPSHOT SET t1_snapshots
  SUSPEND SNAPSHOT POLICY;

Copy

Setzen Sie eine Snapshot-Richtlinie für das Snapshot-Set t1_snapshots fort:

ALTER SNAPSHOT SET t1_snapshots
  RESUME SNAPSHOT POLICY;

Copy

Um den Snapshot-Bezeichner zu finden, der mit den ADD LEGAL HOLD und REMOVE LEGAL HOLD-Klauseln verwendet werden soll, Verwenden Sie normalerweise den SHOW SNAPSHOTS-Befehl, um die geeigneten Snapshots und deren Erstellungszeitpunkte aufzulisten. Das folgende Beispiel zeigt, wie Sie die entsprechenden Snapshots auflisten, einem bestimmten Snapshot eine rechtliche Sperre hinzufügen und diese rechtliche Sperre später entfernen können. Ersetzen Sie Ihren eigenen Rollennamen, den Namen des Snapshot-Sets und den Bezeichner des Snapshots.

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;

Copy