UNDROP VOLUME

Si applica a:spuntato sì Databrick SQL spuntato sì Databricks Runtime 19.11 e superiori spuntato sì solo Unity Catalog

Il UNDROP VOLUME comando recupera un volume eliminato nel Catalogo Unity tramite il suo ID di volume. Usalo per ripristinare un volume che è stato accidentalmente perso. Puoi recuperare un volume perso per 7 giorni dopo il drop.

Il ripristino di un volume è un'operazione di metadati, quindi sia i volumi gestiti che quelli esterni possono essere ripristinati. Lo schema e il catalogo genitore devono comunque esistere.

Per trovare l'ID di un volume perso, usa SHOW VOLUMES DROPPED.

Se un volume live nello stesso schema usa già il nome del volume che vuoi recuperare, rinomina o elimina prima quel volume con ALTER VOLUME o DROP VOLUME, poi esegui UNDROP VOLUME.

I metadati dei volumi, come i privilegi concessi sul volume e sui tag, vengono recuperati. Per un volume gestito, vengono recuperati anche i file memorizzati nel volume.

Syntax

UNDROP VOLUME WITH ID volume_id

Parametro

  • volume_id

    Un STRING letterale sotto forma di UUID che identifica il volume eliminato, come mostrato da SHOW VOLUMES DROPPED.

Non esiste un modulo che recuperi un volume per nome. Devi identificare il volume dal suo ID.

Permissions

UNDROP VOLUME Richiede una delle seguenti cose:

  • Possiedi, o hai MANAGE sopra, il volume, e hai CREATE VOLUME e USE SCHEMA sullo schema, e USE CATALOG sul catalogo.
  • Possiedi, o hai MANAGE sopra, lo schema, e hai USE CATALOG nel catalogo.
  • Possiedi, o possiedi MANAGE , il catalogo.
  • Possiedi il metastore.

Inoltre, devi avere i privilegi necessari per creare il volume che ripristini. Ad esempio, per ripristinare un volume esterno, devi avere CREATE EXTERNAL VOLUME sulla posizione esterna.

Dopo l'esecuzione del comando, la proprietà passa di default al precedente proprietario del volume.

Limitations

Puoi riattivare un volume solo entro 7 giorni dalla sua consegna. Dopo il periodo di recupero, il volume viene eliminato in modo permanente e non può essere recuperato.

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