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>' ]
Copy

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

Name des externen Volumes.

allow_writes

Gibt an, ob Snowflake Dateien in die Speicherorte schreiben kann.

comment

Kommentar zum externen Volume.

Beispiele

Anzeigen aller externen Volumes:

SHOW EXTERNAL VOLUMES;
Copy

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%';
Copy