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.