DROP VOLUME

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

Usuwa określony wolumin.

Note

Po usunięciu woluminu zarządzanego pliki danych bazowych nie zostaną natychmiast usunięte. Wykaz aparatu Unity zachowuje je przez 7 dni, a następnie trwale usuwa je (czyści) w ciągu 48 godzin. Ten okres przechowywania dotyczy tylko czyszczenia plików danych i rozliczeń magazynu — nie umożliwia odzyskania woluminu. Aby uzyskać szczegółowe informacje na temat cyklu życia i rozliczeń plików danych, zobacz Cykl życia magazynu obiektów w wykazie aparatu Unity.

Jeśli woluminu zewnętrznego zostanie opuszczony, metadane dotyczące woluminu zostaną usunięte z katalogu, ale pliki bazowe nie zostaną usunięte.

Permissions

Aby usunąć wolumin, musisz być właścicielem woluminu lub mieć MANAGE go. Musisz również mieć USE CATALOG katalog nadrzędny i USE SCHEMA schemat nadrzędny, w którym znajduje się wolumin.

Zgodnie z hierarchią obiektów właściciele nadrzędnego schematu lub katalogu i użytkownicy z MANAGE programem mogą również wykonać tę operację.

Ostrzeżenie

Nie można odzyskać usuniętego woluminu.

Składnia

DROP VOLUME [ IF EXISTS ] volume_name

Parametr

  • JEŚLI ISTNIEJE

    Jeśli zostało to określone, nie zostanie zgłoszony żaden błąd, gdy wolumin nie istnieje.

  • nazwa wolumenu

    Nazwa woluminu, który ma zostać usunięty. 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