SHOW BACKUP SETS

Listet alle Backup-Sets auf, für die Sie Zugriffsrechte haben. Der Geltungsbereich dieses Befehls kann Ihr gesamtes Konto oder eine bestimmte Datenbank bzw. ein bestimmtes Schema umfassen.

Siehe auch:

CREATE BACKUP SET, ALTER BACKUP SET, DROP BACKUP SET

Syntax

SHOW BACKUP SETS
   [ LIKE '<pattern>' ]
   [ IN { ACCOUNT | DATABASE | DATABASE <db_name> | SCHEMA | SCHEMA <schema_name> }
     [ STARTS WITH '<name_string>' ]
     [ LIMIT <rows> ]
   ]
Copy

Parameter

LIKE 'pattern'

Filtert optional die Befehlsausgabe nach dem Objektnamen. Der Filter verwendet einen Musterabgleich ohne Berücksichtigung der Groß-/Kleinschreibung, aber mit Unterstützung von SQL-Platzhalterzeichen (% und _).

Die folgenden Muster geben beispielsweise die gleichen Ergebnisse zurück:

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

. Standard: Kein Wert (die Ausgabe wird nicht gefiltert).

[ IN ... ]

Gibt optional den Geltungsbereich des Befehls an. Geben Sie eine der folgenden Optionen an:

Wenn Sie das Schlüsselwort ACCOUNT angeben, ruft der Befehl Datensätze für alle Schemas in allen Datenbanken des aktuellen Kontos ab.

Wenn Sie das Schlüsselwort DATABASE angeben, dann gilt Folgendes:

  • Wenn Sie einen Wert für db_name angeben, ruft der Befehl Datensätze für alle Schemas der angegebenen Datenbank ab.

  • Wenn Sie keinen db_name angeben, dann:

    • Wenn es eine aktuelle Datenbank gibt, ruft der Befehl Datensätze für alle Schemas in der aktuellen Datenbank ab.

    • Wenn es keine aktuelle Datenbank gibt, ruft der Befehl Datensätze aller Datenbanken und Schemas im Konto ab.

Wenn Sie das Schlüsselwort SCHEMA angeben, dann gilt Folgendes:

  • Wenn Sie einen qualifizierten Schemanamen angeben (z. B. my_database.my_schema), ruft der Befehl Datensätze für die angegebene Datenbank und das angegebene Schema ab.

  • Wenn Sie einen nicht qualifizierten Wert für schema_name angeben, dann gilt Folgendes:

    • Wenn es eine aktuelle Datenbank gibt, ruft der Befehl Datensätze für das angegebene Schema in der aktuellen Datenbank ab.

    • Wenn keine aktuelle Datenbank vorhanden ist, zeigt der Befehl den Fehler SQL compilation error: Object does not exist, or operation cannot be performed an.

  • Wenn Sie keinen schema_name angeben, dann:

    • Wenn es eine aktuelle Datenbank gibt, dann gilt Folgendes:

      • Wenn es ein aktuelles Schema gibt, dann ruft der Befehl Datensätze für das aktuelle Schema in der aktuellen Datenbank ab.

      • Wenn kein aktuelles Schema vorhanden ist, ruft der Befehl Datensätze für alle Schemas in der aktuellen Datenbank ab.

    • Wenn es keine aktuelle Datenbank gibt, ruft der Befehl Datensätze für alle Datenbanken und alle Schemas im Konto ab.

STARTS WITH 'name_string'

Filtert die Befehlsausgabe optional anhand der Zeichen, die am Anfang des Objektnamens angezeigt werden. Die Zeichenfolge muss in einfache Anführungszeichen gesetzt werden, wobei zwischen Groß-/Kleinschreibung unterschieden wird.

Die folgenden Zeichenfolgen geben beispielsweise unterschiedliche Ergebnisse zurück:

... STARTS WITH 'B' ...
... STARTS WITH 'b' ...

. Standard: Kein Wert (die Ausgabe wird nicht gefiltert)

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)

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

Zeitstempel, wann das Backup-Set erstellt wurde.

name

Name des Backup-Sets.

database_name

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

schema_name

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

object_kind

Typ des Objekts, das das Backup-Set sichert.

object_name

Name des Objekts, das das Backup-Set sichert.

object_database_name

Name der Datenbank, die das Objekt enthält, das von diesem Backup-Set gesichert wird.

object_schema_name

Name des Schemas, das das Objekt enthält, das von diesem Backup-Set gesichert wird.

backup_policy_name

Name der Backup-Richtlinie, die mit diesem Backup-Set verbunden ist.

backup_policy_database_name

Name der Datenbank, die die Backup-Richtlinie enthält.

backup_policy_schema_name

Name des Schemas, das die Backup-Richtlinie enthält.

backup_policy_state

Aktueller Status der Backup-Richtlinie.

owner_role

Name der Rolle mit der OWNERSHIP-Berechtigung für das Backup-Set.

owner_role_type

Typ der Rolle mit der OWNERSHIP-Berechtigung für das Backup-Set.

comment

Kommentar zum Backup-Set.

Beispiele

Alle Backup-Sets auflisten, für die Sie im aktuellen Konto Berechtigungen haben:

SHOW BACKUP SETS IN ACCOUNT;
Copy

Backup-Sets auflisten, die T1 im Namen enthalten:

SHOW BACKUP SETS LIKE '%T1%';
Copy
Sprache: Deutsch