SHOW SNAPSHOT SETS

Listet alle Snapshot-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 SNAPSHOT SET, ALTER SNAPSHOT SET, DROP SNAPSHOT SET

Syntax

SHOW SNAPSHOT SETS
   [ LIKE '<pattern>' ]
   [ IN { ACCOUNT | DATABASE | DATABASE <db_name> | SCHEMA | SCHEMA <schema_name> } ]
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 { ACCOUNT | DATABASE | DATABASE db_name | SCHEMA | SCHEMA schema_name } ]

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.

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, dass das Snapshot-Set erstellt wurde.

name

Name des Snapshot-Sets.

database_name

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

schema_name

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

object_kind

Typ des Objekts, für das das Snapshot-Set einen Snapshot erstellt.

object_name

Name des Objekts, für das das Snapshot-Set einen Snapshot erstellt.

object_database_name

Name der Datenbank, die das Objekt enthält, für das dieses Snapshot-Set einen Snapshot erstellt.

object_schema_name

Name des Schemas, das das Objekt enthält, für das dieses Snapshot-Set einen Snapshot erstellt.

snapshot_policy_name

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

snapshot_policy_database_name

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

snapshot_policy_schema_name

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

comment

Kommentar zum Snapshot-Set.

owner

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

owner_role_type

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

Beispiele

Listen Sie alle Snapshot-Sets auf, für die Sie im aktuellen Konto Berechtigungen haben:

SHOW SNAPSHOT SETS IN ACCOUNT;
Copy

Listet Snapshot-Sets auf, in deren Namen T1 enthalten ist:

SHOW SNAPSHOT SETS LIKE '%T1%';
Copy