Partilhar via

DESCREVER VOLUME

  • Artigo

Aplica-se a:Marque Sim Databricks SQL Marque Sim Databricks Runtime 13.3 LTS e superior Marque Sim somente Unity Catalog

Retorna os metadados de um volume existente. As informações de metadados incluem nome do volume, esquema, catálogo, tipo, comentário e proprietário. Se a opção opcional EXTENDED for especificada, ela retornará as informações básicas de metadados junto com as outras propriedades do catálogo.

Sintaxe

DESCRIBE VOLUME volume_name

Parâmetros

  • volume_name: O nome de um volume existente no Catálogo Unity. Se o nome não existir, uma exceção será lançada.

Devoluções

Um único conjunto de resultados de linha com as seguintes colunas:

  • name STRING NOT NULL: O nome do volume; ele identifica o objeto de volume.
  • catalog STRING NOT NULL: O nome do catálogo que contém o volume.
  • database STRING NOT NULL: O nome do esquema que contém o volume.
  • owner STRING NOT NULL: O principal proprietário do volume.
  • storageLocation STRING: O caminho do local externo onde reside o volume externo. NULL para volumes gerenciados.
  • volumeType STRING NOT NULL: O tipo de volume, valores possíveis: EXTERNAL, MANAGED.
  • comment STRING: Um comentário anexado ao volume.

Exemplos

- 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