聯合國DROP VOLUME

適用於:勾選標記為是 Databricks SQL 勾 選為是 Databricks 執行時間 19.11 及以上版本 勾選是 僅限 Unity 目錄

此 UNDROP VOLUME 指令會透過 Unity 目錄的卷 ID 恢復遺失的卷。 用它來恢復不小心掉落的音量。 掉落的音量可以在掉落後的 7 天內恢復。

還原磁碟區屬於中繼資料操作,因此管理卷與外部磁碟都可以被解開。 父架構與目錄必須仍然存在。

要找到掉落的卷的 ID,請使用 SHOW VOLUMES DROPPED。

如果同一結構中的一個活卷已經使用你想復原的卷名,請先ALTER VOLUMEDROP VOLUME用或 或 重新命名或刪除該卷,然後執行 UNDROP VOLUME。

磁碟區的元資料,例如對磁碟區和標籤所賦予的權限,會被恢復。 對於受管理的卷,儲存在卷中的檔案也會被恢復。

Syntax

UNDROP VOLUME WITH ID volume_id

Parameter

  • volume_id

    一個 STRING 以 UUID 形式存在的字面值,用來識別被丟棄的音量,並以 SHOW VOLUMES DROPPED 顯示。

沒有表格能以名稱恢復卷冊。 你必須透過 ID 來辨識該體積。

Permissions

UNDROP VOLUME 需要以下其中一項:

  • 你擁有或擁有MANAGE這個卷冊,你在結構USE CATALOG和目錄上都有USE SCHEMACREATE VOLUME。
  • 你擁有或擁有MANAGE這個架構,你也在目錄上。USE CATALOG
  • 你擁有或擁有 MANAGE 這本目錄。
  • 你擁有這個 Metastore 的。

此外,你還必須擁有建立你還原的磁碟所需的權限。 例如,要還原外部磁碟,你必須在外部位置擁有 CREATE EXTERNAL VOLUME 。

指令執行後,所有權會自動歸還給前一個磁碟區的擁有者。

Limitations

你只能在一個音量被取消後的 7 天內取消。 恢復期過後,該音量會永久清除,無法恢復。

Examples

-- 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