Compartir a través de

DESCRIBE VOLUME

  • Artículo

Se aplica a:casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 13.3 LTS y versiones posteriores casilla de verificación marcada solo a Unity Catalog

Devuelve los metadatos de un volumen existente. La información de metadatos incluye el nombre del volumen, el esquema, el catálogo, el tipo, el comentario y el propietario. Si se especifica la opción opcional EXTENDED, devuelve la información básica de metadatos junto con las otras propiedades del catálogo.

Sintaxis

DESCRIBE VOLUME volume_name

Parámetros

  • volume_name: el nombre de un volumen existente en Unity Catalog. Si el nombre no existe, se produce una excepción.

Devoluciones

Un conjunto de resultados de una sola fila con las columnas siguientes:

  • name STRING NOT NULL: el nombre del volumen; identifica el objeto de volumen.
  • catalog STRING NOT NULL: el nombre del catálogo que contiene el volumen.
  • database STRING NOT NULL: el nombre del esquema que contiene el volumen.
  • owner STRING NOT NULL: entidad de seguridad propietaria del volumen.
  • storageLocation STRING: ruta de acceso de la ubicación externa donde reside el volumen externo. NULL para volúmenes administrados.
  • volumeType STRING NOT NULL: tipo de volumen, valores posibles: EXTERNAL, MANAGED.
  • comment STRING: un comentario adjunto al volumen.

Ejemplos

- Describe an external volume
> DESCRIBE VOLUME my_external_volume
  name               catalog         database       owner storageLocation                    volumeType comment
  ------------------ --------------- -------------- ----- ---------------------------------- ---------- ---------------
  my_external_volume default_catalog default_schema Alice s3://my-bucket/my-location/my-path EXTERNAL   My first volume

- Describe a managed volume
> DESCRIBE VOLUME managed_volume
  name           catalog         database       owner storageLocation                      volumeType comment
  -------------- --------------- -------------- ----- ------------------------------------ ---------- -----------------------
  managed_volume default_catalog default_schema Alice s3://<metastore-root>/volumes/<uuid> MANAGED    My first managed volume