Compartilhar via


DROP VOLUME

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

Exclui o volume especificado.

Ao excluir um volume gerenciado, os arquivos armazenados nesse volume também são excluídos do locatário de nuvem em 30 dias.

Se um volume externo for descartado, os metadados sobre o volume serão removidos do catálogo, mas os arquivos subjacentes não.

Para remover um volume, você deve ser seu proprietário ou o proprietário do esquema, catálogo ou metastore no qual o volume reside.

Sintaxe

DROP VOLUME [ IF EXISTS ] volume_name

Parâmetro

  • IF EXISTS

    Se especificado, nenhum erro será gerado quando o volume não existir.

  • volume_name

    O nome do volume a ser removido. 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