DESCRIBE EXTERNAL VOLUME¶

Beschreibt die Eigenschaften eines externen Volumes.

DESCRIBE kann mit DESC abgekürzt werden.

Siehe auch:: ALTER EXTERNAL VOLUME, CREATE EXTERNAL VOLUME, DROP EXTERNAL VOLUME, SHOW EXTERNAL VOLUMES

Syntax¶

DESC[RIBE] EXTERNAL VOLUME <name>

Copy

Parameter¶

name: Gibt den Bezeichner für das zu beschreibende externe Volume an. Wenn der Bezeichner Leerzeichen oder Sonderzeichen enthält, muss die gesamte Zeichenfolge in doppelte Anführungszeichen gesetzt werden (z. B. "My object"). Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß-/Kleinschreibung zu beachten.

Ausgabe¶

Die Ausgabe des Befehls enthält die folgenden Spalten, die die Eigenschaften und Metadaten des Objekts beschreiben:

Spalte	Beschreibung
`parent_property`	Die übergeordnete Eigenschaft. Diese Spalte enthält die Eigenschaft `STORAGE_LOCATIONS`, die eine Reihe von benannten Cloudspeicherorten enthält.
`property`	Der Name der Eigenschaft. Diese Spalte kann die in der folgenden Tabelle aufgeführten Eigenschaften enthalten.
`property_type`	Der Typ der Eigenschaft.
`property_value`	Der Wert, der der Eigenschaft zugewiesen ist.
`property_default`	Der Standardwert der Eigenschaft.

Die Spalte property kann die folgenden Eigenschaften eines externen Volume-Objekts enthalten:

Eigenschaft	Beschreibung
`comment`	Der festgelegte Kommentar für das externe Volume, falls vorhanden.
`allow_writes`	Gibt an, ob Schreiboperationen für das externe Volume erlaubt sind.
`storage_location_n`	Details zum Cloudspeicherort, der mit dem externen Volume verbunden ist, wobei `n` eine eindeutige Nummer ist, die den Speicherort von anderen in der Liste `STORAGE_LOCATIONS` unterscheidet, z. B. `storage_location_1`. Weitere Informationen zu Speicherorteigenschaften finden Sie unter CREATE EXTERNAL VOLUME.
`active`	Der Name des aktiven Speicherorts für das externe Volume.

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

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¶

Um die Ausgabe dieses Befehls nachzubearbeiten, können Sie die Funktion RESULT_SCAN verwenden, die die Ausgabe wie eine abfragbare Tabelle behandelt.

Beispiele¶

Beschreiben eines externen Volumes:

DESC EXTERNAL VOLUME my_external_volume;

Copy

Im Folgenden sehen Sie die Ausgabe von DESCRIBE EXTERNAL VOLUME für ein externes Volume mit genau einem Speicherort. Der Eigenschaftswert für STORAGE_LOCATION_1 ist zu Anzeigezwecken abgekürzt.

+-------------------+--------------------+---------------+-------------------------------------------------------------------------------------------+------------------+
| parent_property   | property           | property_type | property_value                                                                            | property_default |
|-------------------+--------------------+---------------+-------------------------------------------------------------------------------------------+------------------|
|                   | ALLOW_WRITES       | Boolean       | true                                                                                      | true             |
| STORAGE_LOCATIONS | STORAGE_LOCATION_1 | String        | {"NAME":"my_storage_us_west","STORAGE_PROVIDER":"S3","STORAGE_BASE_URL":"s3://...", ...}  |                  |
| STORAGE_LOCATIONS | ACTIVE             | String        | my_storage_us_west                                                                        |                  |
+-------------------+--------------------+---------------+-------------------------------------------------------------------------------------------+------------------+