Partilhar via

DROP VOLUME

  • Artigo

Aplica-se a:marca de verificação sim Databricks SQL marca de verificação sim Databricks Runtime 13.3 LTS e superior marca de verificação sim apenas catálogo Unity

Exclui o volume especificado.

Quando você exclui um volume gerenciado, os arquivos armazenados nesse volume também são excluídos do locatário da nuvem dentro de 30 dias.

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 soltar um volume, você deve ter o privilégio de MANAGE no volume, ser seu proprietário ou ser o proprietário do esquema, catálogo ou metastore em que o volume reside.

Sintaxe

DROP VOLUME [ IF EXISTS ] volume_name

Parâmetro

  • SE EXISTE

    Se especificado, nenhum erro é lançado quando o volume não existe.

  • volume_name

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