OSNDROP VOLUME

Platí na:zaškrtnuté ano Databricks SQL označeno ano Databricks Runtime 19.11 a výše zaškrtnuté ano pouze Unity Catalog

Příkaz UNDROP VOLUME obnoví ztracený svazek v Unity Catalog pomocí jeho ID svazku. Použijte ho k obnovení hlasitosti, která byla omylem vypadnuta. Spadnutý objem lze obnovit 7 dní po poklesu.

Obnova svazku je operace metadat, takže jak spravované, tak externí svazky lze odložit. Rodičovské schéma a katalog musí stále existovat.

Pro nalezení ID spadnutého svazku použijte SHOW VOLUMES DROPPED.

Pokud živý svazek ve stejném schématu už používá název svazku, který chcete obnovit, nejprve přejmenujte nebo odeberte tento svazek na ALTER VOLUME nebo DROP VOLUME, a pak spusťte UNDROP VOLUME.

Metadata svazků, jako jsou oprávnění udělená svazku a tagům, jsou obnovena. U spravovaného svazku se také obnoví soubory uložené v tomto svazku.

Syntax

UNDROP VOLUME WITH ID volume_id

Parametr

  • volume_id

    Literál ve formě UUID, který identifikuje vypuštěný svazek, jak je SHOW VOLUMESzobrazeno STRING pomocí DROPPED.

Neexistuje žádný formulář, který by obnovoval svazek podle jména. Musíte svazek identifikovat podle jeho ID.

Permissions

UNDROP VOLUME vyžaduje jednu z následujících podmínek:

  • Vlastníte, nebo máte MANAGE na svazku, a máte CREATE VOLUME na USE SCHEMA schématu, a USE CATALOG na katalogu.
  • Vlastníte, nebo máte MANAGE na sobě schéma, a máte USE CATALOG ho v katalogu.
  • Vlastníte, nebo máte MANAGE katalog.
  • Metastore vlastníte.

Navíc musíte mít oprávnění potřebná k vytvoření svazku, který obnovujete. Například pro obnovení externího svazku musíte mít CREATE EXTERNAL VOLUME na externí lokalitě.

Po spuštění příkazu vlastnictví automaticky přechází na předchozího vlastníka svazku.

Limitations

Svazek lze odpustit pouze do 7 dnů po jeho vydání. Po uplynutí doby zotavení je objem trvale vyčištěn a nelze ho obnovit.

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