Kategorien:

DDL für Tabellen, Ansichten und Sequenzen

SHOW VIEWS

Listet die Ansichten auf, einschließlich der sicheren Ansichten, für die Sie Zugriffsrechte haben. Mit dem Befehl können Sie Ansichten für die aktuelle/angegebene Datenbank oder das angegebene Schema oder für Ihr gesamtes Konto auflisten.

Die Ausgabe gibt Ansichtsmetadaten und -eigenschaften zurück, die nach Datenbank, Schema und Ansichtsname lexikografisch geordnet sind. Dies sollte beachtet werden, wenn Sie die Ergebnisse mit den bereitgestellten Filtern filtern möchten.

Siehe auch:

ALTER VIEW, CREATE VIEW, DROP VIEW

VIEWS-Ansicht (Information Schema)

Syntax

SHOW [ TERSE ] VIEWS [ LIKE '<pattern>' ]
                     [ IN { ACCOUNT | DATABASE [ <db_name> ] | [ SCHEMA ] [ <schema_name> ] } ]
                     [ STARTS WITH '<name_string>' ]
                     [ LIMIT <rows> [ FROM '<name_string>' ] ]

Parameter

TERSE

Gibt optional nur eine Teilmenge der Ausgabespalten zurück:

  • created_on

  • name

  • kind

  • database_name

  • schema_name

Standard: Kein Wert (alle Spalten sind in der Ausgabe enthalten)

LIKE 'Muster'

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 ] Datenbankname | [ SCHEMA ] Schemaname

Gibt optional den Bereich des Befehls an, der bestimmt, ob der Befehl Datensätze nur für die aktuelle/angegebene Datenbank oder das aktuelle/angegebene Schema oder für Ihr gesamtes Konto auflistet:

Das Schlüsselwort DATABASE oder SCHEMA ist nicht erforderlich. Sie können den Gültigkeitsbereich festlegen, indem Sie nur den Datenbank- oder Schemanamen angeben. Ebenso ist der Datenbank- oder Schemaname nicht erforderlich, wenn für die Sitzung derzeit eine Datenbank verwendet wird:

  • Wenn DATABASE oder SCHEMA ohne Namen angegeben wird und für die Sitzung derzeit keine Datenbank verwendet wird, hat der Parameter keine Auswirkung auf die Ausgabe.

  • Wenn SCHEMA mit einem Namen angegeben ist und für die Sitzung derzeit keine Datenbank verwendet wird, muss der Schemaname vollständig mit dem Datenbanknamen qualifiziert sein (z. B. testdb.testschema).

Standard: Abhängig davon, ob für die Sitzung aktuell eine Datenbank verwendet wird:

  • 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 die Standardeinstellung (d. h. der Befehl gibt die Objekte zurück, für die Sie Berechtigungen zum Anzeigen in Ihrem Konto haben).

STARTS WITH 'Namenszeichenfolge'

Filtert die Befehlsausgabe optional anhand der Zeichen, die am Anfang des Objektnamens angezeigt werden. Die Zeichenfolge muss in einfache Anführungszeichen gesetzt werden, wobei die Groß-/Kleinschreibung beachtet werden muss. Zum Beispiel werden bei Folgendem unterschiedliche Ergebnisse zurückgegeben:

... STARTS WITH 'B' ...
... STARTS WITH 'b' ...

Standard: Kein Wert (die Ausgabe wird nicht gefiltert)

LIMIT Zeilen [ FROM 'Namenszeichenfolge' ]

Schränkt optional die maximale Anzahl der zurückgegebenen Zeilen ein und ermöglicht gleichzeitig das „Ausblenden“ der Ergebnisse. Beachten Sie, dass die tatsächliche Anzahl der zurückgegebenen Zeilen möglicherweise unter dem angegebenen Grenzwert liegt (z. B. liegt die Anzahl der vorhandenen Objekte unter dem angegebenen Grenzwert).

Die optionale Unterklausel FROM 'Namenszeichenfolge' dient als „Cursor“ für die Ergebnisse. Dies ermöglicht das Abrufen der angegebenen Anzahl von Zeilen nach der ersten Zeile, deren Objektname mit der angegebenen Zeichenfolge übereinstimmt:

  • Die Zeichenfolge muss in einfache Anführungszeichen gesetzt werden, wobei zwischen Groß-/Kleinschreibung unterschieden wird.

  • Die Zeichenfolge muss nicht den vollständigen Datenbanknamen enthalten. Partielle Namen werden unterstützt.

Standard: Kein Wert (die Ausgabe wird nicht begrenzt)

Bemerkung

Sowohl FROM 'Namenszeichenfolge' als auch STARTS WITH 'Namenszeichenfolge' können in derselben Anweisung kombiniert werden. Beide Bedingungen müssen jedoch erfüllt sein, oder sie heben sich gegenseitig auf und es werden keine Ergebnisse zurückgegeben.

Außerdem werden Objekte in lexikographischer Reihenfolge nach Namen zurückgegeben. Daher gibt FROM 'Namenszeichenfolge' nur Zeilen mit einem höheren lexikografischen Wert zurück als die von STARTS WITH 'Namenszeichenfolge' zurückgegebenen Zeilen.

Beispiel:

  • ... STARTS WITH 'A' LIMIT ... FROM 'B' würde keine Ergebnisse zurückgeben.

  • ... STARTS WITH 'B' LIMIT ... FROM 'A' würde keine Ergebnisse zurückgeben.

  • ... STARTS WITH 'A' LIMIT ... FROM 'AB' würde Ergebnisse zurückgeben (wenn Zeilen mit den Eingabezeichenfolgen übereinstimmen).

Nutzungshinweise

  • Für die Ausführung des Befehls ist kein aktives Warehouse erforderlich.

  • Der Wert für LIMIT Zeilen darf 10000 nicht überschreiten. Wenn LIMIT Zeilen nicht angegeben wird und das Resultset mehr als 10.000 Zeilen hat, führt der Befehl zu einem Fehler.

    Um Ergebnisse anzuzeigen, für die mehr als 10.000 Datensätze vorhanden sind, fügen Sie entweder LIMIT Zeilen ein, oder fragen Sie die entsprechende Ansicht im 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.

  • Die Befehlsausgabe enthält zwar sichere Ansichten, liefert jedoch keine bestimmten Informationen zu diesen Ansichten, es sei denn, Sie verwenden die Rolle, die Eigentümer der Ansicht ist. Um Details für sichere Ansichten anzuzeigen, müssen Sie die Rolle verwenden, der die Ansicht gehört, oder die Ansicht VIEWS im Information Schema.

Ausgabe

Die Befehlsausgabe enthält Spalteneigenschaften und Metadaten in den folgenden Spalten:

Spalte

Beschreibung

created_on

Der Zeitstempel, zu dem die Ansicht erstellt wurde.

name

Der Name der Ansicht.

reserved

(Reserviert für zukünftige Verwendung.)

database_name

Der Name der Datenbank, in der sich die Ansicht befindet.

schema_name

Der Name des Schemas, in dem sich die Ansicht befindet.

owner

Der Eigentümer der Ansicht.

comment

Optionaler Kommentar.

text

Der Text des Befehls, der die Ansicht erstellt hat (z. B. CREATE VIEW ...).

is_secure

„True“, wenn die Ansicht eine sichere Ansicht ist, sonst „false“.

is_materialized

„True“, wenn die Ansicht eine materialisierte Ansicht ist, sonst „false“.

Beispiele

Zeigen Sie alle Ansichten an, deren Namen mit line beginnen, für die Sie über Berechtigungen zum Anzeigen im Schema mydb.public verfügen:

SHOW VIEWS LIKE 'line%' IN mydb.public;

+-------------------------------+---------+----------+---------------+-------------+--------+---------+-------------------------------------------------------+-----------+-----------------+
| created_on                    | name    | reserved | database_name | schema_name | owner  | comment | text                                                  | is_secure | is_materialized |
+-------------------------------+---------+----------+---------------+-------------+--------+---------+-------------------------------------------------------+-----------+-----------------+
| 2019-05-24 18:41:14.247 -0700 | liners1 |          | MYDB          | PUBLIC      | TSMITH |         | create materialized views liners1 as select * from t; | false     | false           |
+-------------------------------+---------+----------+---------------+-------------+--------+---------+-------------------------------------------------------+-----------+-----------------+