CREATE BACKUP SET¶

Syntax¶

CREATE [ OR REPLACE ] BACKUP SET [ IF NOT EXISTS ] <name>
   FOR [ DYNAMIC ] TABLE <table_name>
   [ [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' , ... ] ) ]
   [ WITH BACKUP POLICY <policy_name> ]
   [ COMMENT = <string> ]

CREATE [ OR REPLACE ] BACKUP SET [ IF NOT EXISTS ] <name>
  FOR SCHEMA <schema_name>
   [ [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' , ... ] ) ]
   [ WITH BACKUP POLICY <policy_name> ]
   [ COMMENT = <string> ]

CREATE [ OR REPLACE ] BACKUP SET [ IF NOT EXISTS ] <name>
  FOR DATABASE <database_name>
   [ [ WITH ] TAG ( <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' , ... ] ) ]
   [ WITH BACKUP POLICY <policy_name> ]
   [ COMMENT = <string> ]

Erforderliche Parameter¶

name

Bezeichner für das Backup-Set; der Bezeichner muss für Ihr Konto eindeutig sein.

Darüber hinaus muss der Bezeichner mit einem Buchstaben beginnen und darf keine Leer- oder Sonderzeichen enthalten, es sei denn, die gesamte Bezeichnerzeichenfolge wird in doppelte Anführungszeichen gesetzt (z. B. "My object"). Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß-/Kleinschreibung zu beachten.

Weitere Informationen dazu finden Sie unter Anforderungen an Bezeichner.

FOR [ DYNAMIC ] TABLE table_name

Gibt den Namen der Tabelle oder der dynamischen Tabelle an. In diesem Fall besteht das Backup-Set aus Backups einer einzelnen Tabelle.

FOR SCHEMA schema_name

Gibt den Namen des Schemas an. In diesem Fall repräsentiert das Backup-Set Backups aller Tabellen und anderer Objekte in einem bestimmten Schema.

FOR DATABASE database_name

Gibt den Namen der Datenbank an. In diesem Fall repräsentiert das Backup-Set Backups aller Tabellen, Schemas und anderen Objekte in einer bestimmten Datenbank.

Optionale Parameter¶

OR REPLACE

Wenn bereits ein Backup-Set mit diesem Namen existiert, löschen Sie ihn und erstellen Sie einen neuen. Wenn das Backup-Set aufgrund von Backup-Richtlinienregeln für Aufbewahrungssperren, gesetzlichen Bestimmungen und Ablaufzeiten nicht gelöscht werden kann, schlägt der Befehl fehl. Diese Klausel schließt IF NOT EXISTS aus (und umgekehrt).

IF NOT EXISTS

Erstellt das Backup-Set nur, wenn es kein Backup-Set mit demselben Namen gibt. Wenn bereits ein Backup-Set vorhanden ist, gibt der Befehl eine Erfolgsmeldung zurück, obwohl er keine Auswirkungen hat. Diese Klausel schließt OR REPLACE aus (und umgekehrt).

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.

WITH BACKUP POLICY policy_name

Gibt den Namen der Backup-Richtlinie für das Set an. Die Backup-Richtlinie definiert die Eigenschaften des Backup-Sets, wie z. B. den Zeitplan für Backups, die Aufbewahrungsfrist für jeden Backup und ob verhindert werden soll, dass Backups vor dem Ende der Aufbewahrungsfrist entfernt werden.

Wenn Sie diesen Parameter von dem CREATE BACKUP SET-Befehl weglassen, können Sie eine Richtlinie später mit dem ALTER BACKUP SET-Befehl anwenden.

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.

COMMENT = 'string_literal'

Gibt einen Kommentar für das Backup-Set an.

Standard: Kein Wert

Anforderungen an die Zugriffssteuerung¶

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

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:

Beispiele¶

Erstellen Sie ein Backup-Set namens t1_backups für Tabelle t1:

CREATE BACKUP SET t1_backups
  FOR TABLE t1;

Erstellen Sie ein Backup-Set t1_backups für Tabelle t1 mit einer Backup-Richtlinie:

CREATE BACKUP SET t1_backups
  FOR TABLE t1
  WITH BACKUP POLICY hourly_backup_policy;

Erstellen Sie ein Backup-Set s1_backups für Schema s1 mit einer Backup-Richtlinie:

CREATE BACKUP SET s1_backups
  FOR SCHEMA s1
  WITH BACKUP POLICY hourly_backup_policy;

Erstellen Sie ein Backup-Set d1_backups für Datenbank d1 mit einer Backup-Richtlinie:

CREATE BACKUP SET d1_backups
  FOR DATABASE d1
  WITH BACKUP POLICY hourly_backup_policy;