SHOW EXTERNAL VOLUMES¶
Listet die externen Volumes in Ihrem Konto auf, für die Sie Zugriffsrechte haben.
Die Ausgabe enthält Metadaten und Eigenschaften der externen Volumes.
- Siehe auch:
CREATE EXTERNAL VOLUME, DROP EXTERNAL VOLUME, ALTER EXTERNAL VOLUME, DESCRIBE EXTERNAL VOLUME
Syntax¶
SHOW EXTERNAL VOLUMES [ LIKE '<pattern>' ]
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).
Anforderungen an die Zugriffssteuerung¶
Eine Rolle, die zur Ausführung dieser Operation verwendet wird, muss mindestens die folgenden Berechtigungen haben:
Berechtigung |
Objekt |
Anmerkungen |
|---|---|---|
USAGE |
Externes Volume |
Um ein bestimmtes externes Volume in der Ausgabe für SHOW EXTERNAL VOLUMES zu sehen, muss eine Rolle die Berechtigung USAGE für dieses externe Volume haben. |
Eine Anleitung zum Erstellen einer kundenspezifischen Rolle mit einer bestimmten Gruppe von Berechtigungen finden Sie unter Erstellen von kundenspezifischen Rollen.
Allgemeine Informationen zu Rollen und Berechtigungen zur Durchführung von SQL-Aktionen auf sicherungsfähigen Objekten finden Sie unter Übersicht zur Zugriffssteuerung.
Ausgabe¶
Die Befehlsausgabe enthält Tabelleneigenschaften und Metadaten in den folgenden Spalten:
Spalte |
Beschreibung |
|---|---|
|
Name des externen Volumes. |
|
Gibt an, ob Snowflake Dateien in die Speicherorte schreiben kann. |
|
Kommentar zum externen Volume. |
Nutzungshinweise¶
Für die Ausführung des Befehls ist kein aktives Warehouse erforderlich.
Der Befehl gibt nur Objekte zurück, für die der aktuellen Rolle des aktuellen Benutzers mindestens ein Zugriffsrecht zugewiesen wurde.
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.
Um die Ausgabe dieses Befehls nachzubearbeiten, können Sie den Befehl Pipe-Operator (
->>) oder die RESULT_SCAN-Funktion verwenden. Beide Konstrukte behandeln die Ausgabe als Resultset, das Sie abfragen können.Die Namen der Ausgabespalten für diesen Befehl werden in Kleinbuchstaben generiert. Wenn Sie ein Resultset dieses Befehls mit dem Pipe-Operator oder der RESULT_SCAN-Funktion verbrauchen, verwenden Sie Bezeichner mit doppelten Anführungszeichen für die Spaltennamen in der Abfrage, um sicherzustellen, dass sie mit den Spaltennamen in der gescannten Ausgabe übereinstimmen. Wenn der Name einer Ausgabespalte beispielsweise
typelautet, geben Sie"type"für den Bezeichner an.
Beispiele¶
Anzeigen aller externen Volumes:
SHOW EXTERNAL VOLUMES;
Zeigen Sie alle externen Volumes an, deren Name mit aws beginnt und für die Sie über Berechtigungen zum Anzeigen verfügen:
SHOW EXTERNAL VOLUMES LIKE 'aws%';