SHOW BACKUPS IN BACKUP SET

Listet alle Backups in einem Backup-Set auf.

Siehe auch:

CREATE BACKUP SET, ALTER BACKUP SET, SHOW BACKUP SETS

Syntax

SHOW BACKUPS IN BACKUP SET <name>
  [ LIMIT <rows> ]
Copy

Parameter

name

Gibt den Bezeichner des Backup-Sets 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.

LIMIT rows

Schränkt optional die maximale Anzahl der zurückgegebenen Zeilen ein und ermöglicht gleichzeitig die „Paginierung“ der Ergebnisse. Die tatsächliche Anzahl der zurückgegebenen Zeilen kann geringer sein als das angegebene Limit. Beispielsweise ist die Anzahl der vorhandenen Objekte geringer als das angegebene Limit.

Standard: Kein Wert (die Ausgabe wird nicht begrenzt)

Anforderungen an die Zugriffssteuerung

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

Berechtigung

Anmerkungen

OWNERSHIP

Sie müssen über die OWNERSHIP-Berechtigung für das Backup-Set verfügen, um die darin enthaltenen Backups zu sehen.

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

  • Der Befehl gibt maximal zehntausend Datensätze für den angegebenen Objekttyp zurück, entsprechend den Zugriffsrechten für die zur Ausführung des Befehls verwendete Rolle. Datensätze, die die Grenze von zehntausend Datensätzen überschreiten, werden nicht zurückgegeben, selbst wenn ein Filter angewendet wurde.

    Um Ergebnisse anzuzeigen, für die mehr als zehntausend Datensätze existieren, fragen Sie die entsprechende Ansicht (sofern vorhanden) in Snowflake Information Schema ab.

Ausgabe

Spalte

Beschreibung

created_on

Das Zeitstempel-Backup wird erstellt.

backup_id

Von Snowflake generierter Bezeichner des Backups. Die Backup-ID ist ein UUID-Wert in dem von der :doc:` UUID_STRING</sql-reference/functions/uuid_string>`-Funktion zurückgegebenen Format.

backup_set_name

Name des Backup-Sets, das das Backup enthält.

database_name

Name der Datenbank, die das Backup-Set enthält.

schema_name

Name des Schemas, das das Backup-Set enthält.

expire_on

Zeitstempel, wann das Backup abläuft.

Beispiele

Listet alle Backups im Backup-Set t1_backups auf:

SHOW BACKUPS IN BACKUP SET t1_backups;
Copy

Zeigt das Erstelldatum und die Backup-ID für das älteste Backup im Backup-Satz t1_backups an:

SHOW BACKUPS IN BACKUP SET t1_backups ->>
  SELECT "created_on", "backup_id" FROM $1
    ORDER BY "created_on" LIMIT 1;
Copy

Zeigt die Backup-ID sowie Datum und Uhrzeit, zu der das endgültige Backup im Backup-Set t1_backups abläuft, an. In diesem Beispiel wird davon ausgegangen, dass die Backup-Richtlinie keinen Zeitplan enthält oder die Backup-Richtlinie für das Backup-Set angehalten wurde, sodass dem Backup-Set keine neuen Backups hinzugefügt werden. Sie warten nur darauf, dass alle vorhandenen Backups ablaufen, sodass Sie das Backup-Set löschen können.

SHOW BACKUPS IN BACKUP SET t1_backups ->>
  SELECT "expire_on", "backup_id" FROM $1
    ORDER BY "expire_on" DESC LIMIT 1;
Copy
Sprache: Deutsch