DESCRIBE EXTERNAL VOLUME¶

Décrit les propriétés d’un volume externe.

DESCRIBE peut être abrégé en DESC.

Voir aussi :: ALTER EXTERNAL VOLUME , CREATE EXTERNAL VOLUME , DROP EXTERNAL VOLUME , SHOW EXTERNAL VOLUMES

Syntaxe¶

DESC[RIBE] EXTERNAL VOLUME <name>

Copy

Paramètres¶

name: Indique l’identificateur du volume externe à décrire. Si l’identificateur contient des espaces ou des caractères spéciaux, toute la chaîne doit être délimitée par des guillemets doubles (par exemple, "My object"). Les identificateurs entre guillemets doubles sont également sensibles à la casse.

Sortie¶

La sortie de la commande comprend les colonnes suivantes, qui décrivent les propriétés et les métadonnées de l’objet :

Colonne	Description
`parent_property`	La propriété parente. Cette colonne inclut la propriété `STORAGE_LOCATIONS`, qui contient un ensemble d’emplacements de stockage Cloud nommés.
`property`	Nom de la propriété. Cette colonne peut inclure les propriétés répertoriées dans le tableau suivant.
`property_type`	Type de propriété.
`property_value`	Valeur attribuée à la propriété.
`property_default`	Valeur par défaut de la propriété.

La colonne property peut inclure les propriétés suivantes d’un objet de volume externe :

Propriété	Description
`comment`	Commentaire défini pour le volume externe, le cas échéant.
`allow_writes`	Spécifie si les opérations d’écriture sont autorisées pour le volume externe.
`storage_location_n`	Détails d’un emplacement de stockage Cloud associé au volume externe, où `n` est un numéro unique qui distingue l’emplacement des autres dans la liste `STORAGE_LOCATIONS` ; par exemple, `storage_location_1`. Pour plus d’informations sur les propriétés des emplacements de stockage, voir CREATE EXTERNAL VOLUME.
`active`	Nom de l”emplacement de stockage actif du volume externe.

Exigences en matière de contrôle d’accès¶

Un rôle utilisé pour exécuter cette commande SQL doit avoir les privilèges suivants définis au minimum ainsi :

Privilège	Objet	Remarques
USAGE	Volume externe

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Notes sur l’utilisation¶

Pour post-traiter la sortie de cette commande, vous pouvez utiliser la fonction RESULT_SCAN, qui traite la sortie comme une table qui peut être interrogée.

Exemples¶

Décrivez un volume externe :

DESC EXTERNAL VOLUME my_external_volume;

Copy

L’exemple suivant montre la sortie de DESCRIBE EXTERNAL VOLUME pour un volume externe avec un emplacement de stockage. La valeur de propriété de STORAGE_LOCATION_1 est abrégée à des fins d’affichage.

+-------------------+--------------------+---------------+-------------------------------------------------------------------------------------------+------------------+
| 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                                                                        |                  |
+-------------------+--------------------+---------------+-------------------------------------------------------------------------------------------+------------------+