联合国DROP VOLUME

适用于:勾选标记为是 Databricks SQL 勾选为是 Databricks 运行时 19.11 及以上版本 勾选为 仅限 Unity 目录

该 UNDROP VOLUME 命令通过 Unity 目录中的卷 ID 恢复丢失的卷。 用它来恢复意外丢失的音量。 掉落的音量可以在掉落后7天内恢复。

恢复卷是元数据操作,因此管理和外部卷都可以被解封。 父模式和目录必须仍然存在。

要查找丢弃卷的ID,请使用 SHOW VOLUMES DROPPED。

如果同一模式中的一个活跃卷已经使用你想恢复的卷名,请先 ALTER VOLUME 用 或 DROP VOLUME替换或丢弃该卷,然后运行 UNDROP VOLUME。

卷元数据,如对卷和标签授予的权限,会被恢复。 对于管理卷,存储在卷中的文件也会被恢复。

Syntax

UNDROP VOLUME WITH ID volume_id

Parameter

  • volume_id

    一个STRING以UUID形式出现的文字,用来识别被丢弃的卷,显示为SHOW VOLUMESDROPPED。

没有任何表格能按名称恢复卷册。 你必须通过编号来识别体积。

Permissions

UNDROP VOLUME 需要以下一项:

  • 你拥有或拥有MANAGE卷册,你在模式USE CATALOG和目录上都有CREATE VOLUMEUSE SCHEMA。
  • 你拥有或拥有 MANAGE 该模式,目录中也有 USE CATALOG 。
  • 你拥有,或者说你已经拥有 MANAGE 这本目录。
  • 你拥有元商店。

此外,你还必须拥有创建你还原的卷所需的权限。 例如,要恢复外部卷,必须在外部位置设置 CREATE EXTERNAL VOLUME 。

命令运行后,所有权默认归还给之前的卷所有者。

局限性

你只能在掉落后7天内取消一个卷。 恢复期过后,该体积将被永久清除,无法恢复。

示例

-- Use SHOW VOLUMES DROPPED to find the ID of the dropped volume.
> SHOW VOLUMES DROPPED IN my_catalog.my_schema;
  catalog     schema     volume_name  volume_id                            owner         comment created_at                    created_by
  ----------- ---------- ------------ ------------------------------------ ------------- ------- ----------------------------- -------------
  my_catalog  my_schema  my_volume    6ca7be55-8f58-47a7-85ee-7a59082fd17a alf@melmak.et         2023-05-03 AD at 18:17:00 UTC alf@melmak.et

-- Undrop the volume by its ID.
-- Enclose the volume ID in single quotation marks.
> UNDROP VOLUME WITH ID '6ca7be55-8f58-47a7-85ee-7a59082fd17a';
  OK