Поделиться через

DROP VOLUME

  • Статья

применимо:отмечено Databricks SQL отмечено Databricks Runtime 13.3 LTS и выше отмечено только Unity Catalog

Удаляет указанный том.

При удалении управляемого тома файлы, хранящиеся в этом томе, хранятся в течение 7 дней. Через 7 дней данные помечаются для удаления из облачного тенанта во время регулярных операций обслуживания.

Если внешний том удаляется, метаданные о томе удаляются из каталога, но базовые файлы не удаляются.

Чтобы удалить том, необходимо иметь права MANAGE на томе, быть его владельцем или быть владельцем схемы, каталога или хранилища метаданных, в котором находится том.

Синтаксис

DROP VOLUME [ IF EXISTS ] volume_name

Параметр

  • IF EXISTS

    Если указано, ошибка не возникает, если том не существует.

  • volume_name

    Имя тома, который нужно удалить. Если том не удается найти, Azure Databricks выдает ошибку.

Примеры

– 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