SHOW STAGES¶

Listet alle Stagingbereiche auf, für die Sie Zugriffsrechte haben. Mit diesem Befehl können Sie die Stagingbereiche für ein bestimmtes Schema oder eine angegebene Datenbank (oder das aktuelle Schema/die aktuelle Datenbank für die Sitzung) oder Ihr gesamtes Konto auflisten.

Siehe auch:: CREATE STAGE, ALTER STAGE, DROP STAGE, DESCRIBE STAGE

Syntax¶

SHOW STAGES [ LIKE '<pattern>' ]
            [ IN
                 {
                   ACCOUNT                  |

                   DATABASE                 |
                   DATABASE <database_name> |

                   SCHEMA                   |
                   SCHEMA <schema_name>     |
                   <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 ... ]

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

ACCOUNT

Gibt Datensätze für das gesamte Konto zurück.

DATABASE, . DATABASE db_name

Gibt Datensätze für die aktuell verwendete Datenbank oder eine angegebene Datenbank (db_name) zurück.

Wenn Sie DATABASE ohne db_name angeben und aktuell keine Datenbank in Verwendung ist, hat das Schlüsselwort keine Auswirkungen auf die Ausgabe.

SCHEMA, . SCHEMA schema_name, . schema_name

Gibt Datensätze für das aktuell verwendete Schema oder ein angegebenes Schema (schema_name) zurück.

SCHEMA ist optional, wenn aktuell eine Datenbank in Verwendung ist oder wenn Sie für schema_name den vollqualifizierten Schemanamen (z. B. db.schema) angeben.

Wenn aktuell keine Datenbank in Verwendung ist, hat die Angabe von SCHEMA keine Auswirkungen auf die Ausgabe.

Standard: Abhängig davon, ob für die Sitzung aktuell eine Datenbank in Verwendung ist:

Datenbank: DATABASE ist der Standardwert (d. h. der Befehl gibt die Objekte zurück, für die Sie Berechtigungen zum Anzeigen in der Datenbank haben).
Keine Datenbank: ACCOUNT ist der Standardwert (d. h. der Befehl gibt die Objekte zurück, für die Sie Berechtigungen zum Anzeigen in Ihrem Konto haben).

Nutzungshinweise¶

Spalten, die mit dem Präfix is_ beginnen, geben entweder Y (ja) oder N (nein) zurück.
Für die Ausführung des Befehls ist kein aktives Warehouse erforderlich.
Der Befehl gibt maximal 10.000 Datensätze für den angegebenen Objekttyp zurück, wie durch die Zugriffsrechte für die Rolle vorgegeben, die zur Ausführung des Befehls verwendet wird. Datensätze, die über dem Limit von 10.000 liegen, werden nicht zurückgegeben, selbst wenn ein Filter angewendet wird.

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

Um die Ausgabe dieses Befehls nachzubearbeiten, können Sie die Funktion RESULT_SCAN verwenden, die die Ausgabe wie eine abfragbare Tabelle behandelt.

Ausgabe¶

Die Ausgabe dieses Befehls enthält Eigenschaften und Metadaten des Stagingbereichs in den folgenden Spalten:

Spalte	Beschreibung
created_on	Datum und Uhrzeit der Erstellung des Stagingbereichs.
name	Name des Stagingbereichs.
database_name	Datenbank, in der der Stagingbereich gespeichert ist.
schema_name	Schema, in dem der Stagingbereich gespeichert ist.
url	URL bei einem externen Stagingbereich. Leer bei einem internen Stagingbereich.
has_credentials	Zeigt an, dass der externe Stagingbereich über Zugriffsanmeldeinformationen verfügt. Immer `N` bei einem internen Stagingbereich.
has_encryption_key	Zeigt an, dass der externe Stagingbereich verschlüsselte Dateien enthält. Immer `N` bei einem internen Stagingbereich.
owner	Rolle, der der Stagingbereich gehört.
comment	Kommentar zum Stagingbereich.
region	Region, in der sich der Stagingbereich befindet.
type	Gibt an, ob es sich bei dem Stagingbereich um einen externen oder internen Stagingbereich handelt und ob der interne Stagingbereich permanent oder temporär ist.
cloud	Name des Cloudanbieters. Immer `NULL` bei einem internen Stagingbereich.
notification_channel	Amazon Resource Name der Amazon SQS-Warteschlange für den Stagingbereich. Veraltete Spalte.
storage_integration	Der der Speicherintegration zugeordnete Stagingbereich. Immer `NULL` bei einem internen Stagingbereich.
endpoint	Der S3-kompatible API-Endpunkt, der mit dem Stagingbereich verbunden ist; bei nicht S3-kompatiblen Stagingbereichen immer `NULL`.
owner_role_type	Der Typ der Rolle, die Eigentümer des Objekts ist, entweder `ROLE` oder `DATABASE_ROLE`. . Wenn eine Snowflake Native App Eigentümer des Objekts ist, ist der Wert `APPLICATION`. . Wenn Sie das Objekt löschen, gibt Snowflake NULL zurück, da ein gelöschtes Objekt keine Eigentümerrolle hat.
directory_enabled	Gibt an, ob der Stagingbereich über eine aktivierte Verzeichnistabelle verfügt. `Y`, wenn eine Verzeichnistabelle aktiviert ist, `N`, wenn sie nicht aktiviert ist.

Weitere Informationen zu den Eigenschaften von Stagingbereichen finden Sie unter CREATE STAGE.