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 dieses SQL-Befehls 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.
Nutzungshinweise¶
Für die Ausführung des Befehls ist kein aktives Warehouse erforderlich.
Um die Ausgabe dieses Befehls nachzubearbeiten, können Sie die Funktion RESULT_SCAN verwenden, die die Ausgabe wie eine abfragbare Tabelle behandelt.
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. |
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%';