ONZDROP VOLUME

Dotyczy do:zaznaczono tak, Databricks SQL zaznaczyło tak, Databricks Runtime 19.11 i wyższe zaznaczone, zaznaczone tak, tylko Unity Catalog

Polecenie odzyskuje UNDROP VOLUME upuszczony woluminus w Katalogu Unity na podstawie jego ID woluminu. Użyj go, aby przywrócić głośność, która została przypadkowo upuszczona. Możesz odzyskać utracony volumen przez 7 dni po dropie.

Przywracanie woluminu jest operacją metadanych, więc zarówno zarządzane, jak i zewnętrzne woluminy mogą zostać odrzucone. Schemat nadrzędny i katalog muszą nadal istnieć.

Aby znaleźć ID woluminu, który upuścił, użyj SHOW VOLUMES DROPPED.

Jeśli live volume w tym samym schemacie już używa nazwy woluminu, który chcesz odzyskać, najpierw zmienij nazwę lub usuń ten wolumin, ALTER VOLUMEDROP VOLUMEa następnie uruchom UNDROP VOLUME.

Metadane woluminów, takie jak uprawnienia przyznane wolumin i tagi, są odzyskiwane. Dla woluminów zarządzanych pliki przechowywane w woluminie również są odzyskiwane.

Syntax

UNDROP VOLUME WITH ID volume_id

Parameter

  • volume_id

    Dosłownik STRING w postaci UUID identyfikujący upuszczony tom, wyświetlany przez SHOW VOLUMES DROPPED.

Nie ma formy, która odtwarza tom z nazwy. Musisz zidentyfikować woluminę po jej ID.

Permissions

UNDROP VOLUME wymaga jednego z następujących warunków:

  • Posiadasz lub masz MANAGE na nim ten tom, CREATE VOLUME masz i USE SCHEMA schemat, i USE CATALOG katalog.
  • Posiadasz lub masz MANAGE na sobie schemat i USE CATALOG masz go w katalogu.
  • Posiadasz lub masz MANAGE katalog.
  • Jesteś właścicielem metastore.

Dodatkowo musisz mieć uprawnienia niezbędne do stworzenia wolumu, który odnawiasz. Na przykład, aby przywrócić zewnętrzny wolumin, musisz mieć CREATE EXTERNAL VOLUME na zewnętrznej lokalizacji.

Po uruchomieniu polecenia własność domyślnie przechodzi do poprzedniego właściciela woluminów.

Limitations

Możesz cofnąć wolumy tylko w ciągu 7 dni od jego wyjęcia. Po upływie okresu regeneracji objętość jest trwale usuwana i nie może być odzyskana.

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