DROP VOLUME

Aplica-se a:sim, marcado Databricks SQL sim, marcado Databricks Runtime 13.3 LTS e superior sim, marcado apenas Catálogo Unity

Exclui o volume especificado.

Note

Quando elimina um volume gerido, os ficheiros de dados subjacentes não são eliminados imediatamente. O Unity Catalog mantém-nos durante 7 dias e depois apaga-os permanentemente (elimina) no prazo de 48 horas. Este período de retenção aplica-se apenas à limpeza de ficheiros de dados e à faturação de armazenamento — não torna o volume recuperável. Para detalhes sobre o ciclo de vida dos ficheiros de dados e faturação, consulte Ciclo de vida de armazenamento de objetos no Unity Catalog.

Se um volume externo for descartado, os metadados sobre o volume serão removidos do catálogo, mas os ficheiros físicos não serão eliminados.

Para descartar um volume, deve-se ter o privilégio de MANAGE no volume, ser o seu proprietário, ou ser o proprietário do esquema, catálogo ou metastore em que o volume reside.

Advertência

Um volume caído não pode ser recuperado.

Sintaxe

DROP VOLUME [ IF EXISTS ] volume_name

Parâmetro

  • SE EXISTE

    Se for especificado, nenhum erro é gerado quando o volume não existe.

  • volume_name

    O nome do volume a ser eliminado. Se o volume não puder ser encontrado, o Azure Databricks gerará um erro.

Exemplos

– Drop a volume named 'my_volume'
> DROP VOLUME my_volume
  OK

– Drop a volume named `my_volume` under catalog `my_catalog` and schema `my_schema
> DROP VOLUME my_catalog.my_schema.my_volume
  OK

– The volume must exist
> DROP VOLUME my_volume
  Error

– Drop a volume named `my_volume` only if it exists
> DROP VOLUME IF EXISTS my_volume
  OK