Partilhar via


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.

Quando você exclui um volume gerenciado, os arquivos armazenados nesse volume são retidos por 7 dias. Após 7 dias, os dados são marcados para exclusão do seu locatário de nuvem durante as operações de manutenção regulares.

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