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.
Zur Weiterverarbeitung der Ausgabe dieses Befehls können Sie die Funktion RESULT_SCAN verwenden, die die Ausgabe wie eine abfragbare Tabelle behandelt. Sie können auch den Pipe-Operator verwenden, um die Ausgabe dieses Befehls abzufragen.
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%';