DESCRIBE VOLUME

  • Artigo

Aplica-se a: verificação marcada como sim SQL do Databricks verificação marcada como sim Databricks Runtime 13.3 LTS e superior marca de seleção positiva Somente Catálogo do Unity

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 alternativa 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 do Unity. Se o nome não existir, será gerada uma exceção.

Retorna

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

  • name STRING NOT NULL: o nome do volume; identifica o objeto do 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: a entidade de segurança que possui o volume.
  • storageLocation STRING: o caminho do local externo em que o volume externo reside. NULL para volumes gerenciados.
  • volumeType STRING NOT NULL: o tipo do 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