SHOW <Objekte>

Listet die vorhandenen Objekte des angegebenen Objekttyps auf. Die Ausgabe enthält Metadaten für die Objekte, einschließlich:

  • Allgemeine Eigenschaften (Name, Erstellungszeitstempel, Eigentümerrolle, Kommentar usw.)

  • Objektspezifische Eigenschaften

Siehe auch:

CREATE <Objekt>, DESCRIBE <Objekt>

Allgemeine Nutzungshinweise

  • SHOW-Befehle erfordern kein laufendes Warehouse zur Ausführung.

  • SHOW-Befehle geben nur Objekte zurück, für die der aktuellen Rolle des aktuellen Benutzers die erforderlichen Zugriffsrechte erteilt wurden. Beispiel:

    • Die Ausgabe SHOW DATABASES enthält die Datenbanken, für die die Benutzerrolle die Berechtigung OWNERSHIP oder USAGE hat.

    • Die Ausgabe SHOW SCHEMAS enthält die Schemata, für die die Benutzerrolle die Berechtigung OWNERSHIP oder USAGE hat.

    • Die Ausgabe SHOW TABLES enthält die Tabellen, für die die Benutzerrolle über Berechtigungen verfügt. Die Rolle muss außerdem über die Berechtigung USAGE für die übergeordnete Datenbank und das übergeordnete Schema verfügen.

    • Das Zugriffsrecht MANAGE GRANTS gibt seinem Eigentümer implizit die Möglichkeit, jedes Objekt im Konto anzuzeigen. Standardmäßig haben nur der Kontoadministrator (Benutzer mit der Rolle ACCOUNTADMIN) und der Systemadministrator (Benutzer mit der Rolle SECURITYADMIN) die Berechtigung MANAGE GRANTS.

  • Die Ausgabe der meisten SHOW-Befehle kann mit den folgenden Klauseln gesteuert werden:

    • Mit der optionalen LIKE-Klausel kann die Liste der nach Name zurückgegebenen Objekte gefiltert werden.

    • Die Datenbankobjekttypen bieten eine zusätzliche, optionale IN-Klausel, mit der der Befehlsbereich entweder auf ein bestimmtes Schema bzw. eine bestimmte Datenbank oder auf das gesamte Konto festgelegt werden kann.

    Bemerkung

    Die Verwendung von SHOW-Befehlen ohne eine IN-Klausel in einem Datenbankkontext kann zu weniger Ergebnissen als erwartet führen.

    Wenn keine IN-Klausel verwendet wird, werden Objekte mit demselben Namen nur einmal angezeigt. Wenn Sie z. B. die Tabelle t1 in schema1 und t1 in schema2 haben und beide im Geltungsbereich des von Ihnen angegebenen Datenbankkontexts liegen (d. h., die von Ihnen ausgewählte Datenbank ist die übergeordnete Datenbank von schema1 und schema2), dann zeigt SHOW TABLES nur eine der t1-Tabellen an.

  • Columns that start with the prefix is_ return either Y (yes) or N (no).

  • 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.