ALTER BACKUP SET

Ändert die Eigenschaften für ein Backup-Set. Diese Operation kann eine der folgenden sein:

  • Erstellen eines neuen Backups, das Teil des Backup-Sets wird.

  • Entfernen eines alten Backups aus dem Backup-Set.

  • Anhalten oder Fortsetzen der geplanten Backups und der geplanten Löschung von Backups, die in der Backup-Richtlinie festgelegt sind.

  • Anwenden einer Backup-Richtlinie auf ein Backup-Set, das noch keine Richtlinie hat.

  • Hinzufügen oder Entfernen einer gesetzlichen Aufbewahrungsfrist für ein bestimmtes Backup innerhalb des Backup-Sets.

  • Angeben oder Entfernen eines Kommentars zum Backup-Set.

Siehe auch:

CREATE BACKUP SET, DROP BACKUP SET, SHOW BACKUP SETS

Syntax

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

Parameter

name

Gibt den Bezeichner des Backups 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 BACKUP

Erstellen Sie manuell ein Backup im Set. Wenn die Backup-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 Backup-Set enthalten sind. Sie können auch jederzeit neue Backups im Backup-Set erstellen, selbst wenn die Backups nach einem regelmäßigen Zeitplan erfolgen.

APPLY BACKUP POLICY policy_name [ FORCE ]

Gibt die Backup-Richtlinie an, die an das Backup-Set angehängt werden soll.

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

Wichtig

Das Anwenden einer Backup-Richtlinie mit einer Aufbewahrungssperre auf ein Backup-Set ist unumkehrbar. Aufgrund der starken Garantien, die für die Einhaltung gesetzlicher Vorschriften erforderlich sind, können Sie die Sperre nicht mehr widerrufen, nachdem Sie einem Backup-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 Backup-Set mit einer langen Ablauffrist festlegen, um unerwartete Speichergebühren für nicht löschbare Backup-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 Backups, auch solche mit Aufbewahrungssperren. Das Löschen einer Snowflake-Organisation erfordert die Einbeziehung des Snowflake-Supports. Das kann ein Administrator nicht versehentlich tun.

SUSPEND BACKUP [ { CREATION | EXPIRATION } ] POLICY

Aussetzen einer Backup-Richtlinie im Backup-Set Sie können die gesamte Backup-Richtlinie oder nur die Erstellungs- oder Ablaufvorgänge aussetzen. Wenn Sie SUSPEND BACKUP 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 BACKUP [ { CREATION | EXPIRATION } ] POLICY

Setzen Sie eine ausgesetzte Backup-Richtlinie im Set fort. Sie können die gesamte Backup-Richtlinie oder nur die Erstellungs- oder Ablaufvorgänge wieder aufnehmen. Wenn Sie RESUME BACKUP 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 BACKUP IDENTIFIER 'backup_id'

Löschen Sie ein Backup im Backup-Set nach ID. Die Backup-ID ist ein UUID-Wert in dem von der :doc:` UUID_STRING</sql-reference/functions/uuid_string>`-Funktion zurückgegebenen Format. Snowflake erlaubt nur das Löschen des ältesten Backups aus dem Backup-Set. Weitere Informationen dazu finden Sie unter Backups aus Backup-Sets löschen.

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

Fügt einem bestimmten Backup innerhalb des Backup-Sets eine gesetzliche Aufbewahrungsfrist hinzu oder entfernt sie. Weitere Informationen zu gesetzlichen Aufbewahrungsfristen für WORM-Backups 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 das Backup-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 Backup-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 Backup-Sets verwendet wird, muss die OWNERSHIP-Berechtigung für das Backup-Set haben.

APPLY BACKUP RETENTION LOCK

Wenn die auf ein Backup-Set angewendete Backup-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 Backup 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 Backup-Richtlinie kann den ALTER BACKUP SET-Befehl mit der APPLY BACKUP POLICY-Klausel verwenden, um die Backup-Richtlinie zu einem bereits vorhandenen Backup-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 Backup-Richtlinie eine Aufbewahrungssperre angewendet wurde und sich im Backup-Set noch nicht abgelaufene Backups befinden, können Sie das Backup-Set nicht löschen. In diesem Fall müssen Sie warten, bis alle Backups im Set abgelaufen sind. Diese Einschränkung gilt auch für privilegierte Rollen wie ACCOUNTADMIN und für den Snowflake-Support. Aus diesem Grund sollten Sie vorsichtig sein, wenn Sie in einer Backup-Richtlinie eine Aufbewahrungssperre und einen langen Ablaufzeitpunkt angeben.

Beispiele

Fügen Sie manuell ein Backup zum Backup-Set t1_backups hinzu:

ALTER BACKUP SET t1_backups
  ADD BACKUP;
Copy

Aktualisieren Sie die Backup-Richtlinie für das Backup-Set t1_backups:

ALTER BACKUP SET t1_backups
  APPLY BACKUP POLICY daily_backup_policy;
Copy

Setzen Sie die Backup-Richtlinie für das Backup-Set t1_backup aus:

ALTER BACKUP SET t1_backups
  SUSPEND BACKUP POLICY;
Copy

Setzen Sie eine Backup-Richtlinie für das Backup-Set t1_backups fort:

ALTER BACKUP SET t1_backups
  RESUME BACKUP POLICY;
Copy

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

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
Sprache: Deutsch