DROP VOLUME

适用于:已勾选是 Databricks SQL 已勾选是 Databricks Runtime 13.3 LTS 及更高版本 已勾选是 仅限 Unity Catalog

删除指定的卷。

注释

删除 托管卷时,不会立即删除基础数据文件。 Unity 目录将保留 7 天,然后在 48 小时内永久删除(清除)。 有关数据文件生命周期和计费的详细信息,请参阅 Unity 目录中的对象存储生命周期。

如果丢弃 外部卷 ,该卷会从目录中删除,但底层文件不会被删除。

Unity 目录支持DROP VOLUMEUN命令来恢复丢失的托管卷和外部卷。 音量在被投放后可恢复7天。

Permissions

若要删除卷,你必须是卷的所有者或 MANAGE 卷的所有者。 还必须在父目录和USE CATALOG卷所在的父架构上具有USE SCHEMA。

根据 对象层次结构,父架构或目录的所有者以及具有 MANAGE 任一对象的用户也可以执行此操作。 他们所需的使用权限取决于他们所拥有的所有权或 MANAGE。 请参阅 MANAGE 的使用权限要求。

语法

DROP VOLUME [ IF EXISTS ] volume_name

参数

  • 如果存在

    如果已指定,则在没有卷时,不会引发错误。

  • 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