PBBDROP VOLUME

Berlaku untuk:tanda centang ya Databricks SQL dicentang ya Databricks Runtime 19.11 ke atas dicentang ya hanya Unity Catalog

Perintah ini UNDROP VOLUME memulihkan volume yang hilang di Unity Catalog berdasarkan ID volumenya. Gunakan untuk mengembalikan volume yang secara tidak sengaja jatuh. Anda dapat memulihkan volume yang hilang selama 7 hari setelah penurunan tersebut.

Memulihkan volume adalah operasi metadata, sehingga baik volume yang dikelola maupun eksternal dapat dihapuskan. Skema induk dan katalog harus masih ada.

Untuk menemukan ID volume yang terlepas, gunakan SHOW VOLUMES DROPPED.

Jika volume live dalam skema yang sama sudah menggunakan nama volume yang ingin Anda pulihkan, ganti nama atau hapus volume tersebut terlebih dahulu dengan ALTER VOLUME atau DROP VOLUME, lalu jalankan UNDROP VOLUME.

Metadata volume, seperti hak istimewa yang diberikan pada volume dan tag, akan dipulihkan. Untuk volume yang dikelola, file yang disimpan dalam volume juga akan dipulihkan.

Syntax

UNDROP VOLUME WITH ID volume_id

Parameter

  • volume_id

    Sebuah STRING literal dalam bentuk UUID yang mengidentifikasi volume yang dijatuhkan, seperti yang ditampilkan oleh SHOW VOLUMES DROPPED.

Tidak ada bentuk yang memulihkan volume berdasarkan nama. Anda harus mengidentifikasi volume berdasarkan ID-nya.

Permissions

UNDROP VOLUME memerlukan salah satu dari berikut ini:

  • Anda memiliki, atau memiliki MANAGE , volume tersebut, dan Anda memiliki CREATE VOLUME dan USE SCHEMA di skema, serta USE CATALOG di katalog.
  • Anda memiliki, atau memiliki MANAGE , skema tersebut, dan Anda memilikinya USE CATALOG di katalog.
  • Anda memiliki, atau memiliki MANAGE , katalog tersebut.
  • Anda memiliki metastore.

Selain itu, Anda harus memiliki hak istimewa yang diperlukan untuk membuat volume yang Anda pulihkan. Misalnya, untuk memulihkan volume eksternal, Anda harus memiliki CREATE EXTERNAL VOLUME di lokasi eksternal.

Setelah perintah dijalankan, kepemilikan default menjadi pemilik volume sebelumnya.

Limitations

Anda hanya bisa membatalkan volume dalam waktu 7 hari setelah volume itu dijatuhkan. Setelah masa pemulihan berlalu, volume tersebut dibersihkan secara permanen dan tidak dapat dipulihkan.

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