Kategorien:

DDL-Befehle

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 oder eine bestimmte Datenbank oder auf das gesamte Konto festgelegt werden kann.

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