Udostępnij za pośrednictwem

DROP VOLUME

  • Artykuł

Dotyczy:zaznaczone jako tak Databricks SQL zaznaczone jako tak Databricks Runtime 13.3 LTS i nowsze zaznaczone jako tak tylko Unity Catalog

Usuwa określony wolumin.

Po usunięciu woluminu zarządzanego pliki przechowywane w tym woluminie są również usuwane z dzierżawy chmury w ciągu 30 dni.

Jeśli wolumin zewnętrzny zostanie odłączony, metadane dotyczące woluminu zostaną usunięte z systemu catalog, ale zasadnicze pliki nie zostaną usunięte.

Aby usunąć wolumin, musisz mieć uprawnienia MANAGE na woluminie, być jego właścicielem lub być właścicielem schema, cataloglub magazynu metadanych, w którym znajduje się wolumin.

Składnia

DROP VOLUME [ IF EXISTS ] volume_name

Parametr

  • JEŚLI ISTNIEJE

    Jeśli zostanie określony, nie zostanie zgłoszony żaden błąd, gdy wolumin nie istnieje.

  • volume_name

    Nazwa woluminu, który ma zostać porzucony. Jeśli nie można odnaleźć woluminu usługi Azure Databricks, wystąpi błąd.

Przykłady

– 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