Compartir a través de

DESCRIBE VOLUME

Se aplica a:comprobar sí marcado Databricks SQL comprobar sí marcado Databricks Runtime 13.3 LTS y superior comprobar sí marcado Solo 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.

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.

Devuelve

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

  • name STRING NOT NULL: el nombre del volumen; identifica el objeto 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
  • Last updated on