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 solo casilla de verificación marcada 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