UNDROP VOLUME

Se aplica a:con marca de verificación sí Databricks SQL marcado sí Databricks Runtime 19.11 y superiores con marca marcada sí Solo Unity Catálogo

El UNDROP VOLUME comando recupera un volumen perdido en el Catálogo de Unity por su ID de volumen. Úsalo para restaurar un volumen que se perdió accidentalmente. Puedes recuperar un volumen perdido durante 7 días después de la caída.

Restaurar un volumen es una operación de metadatos, por lo que tanto los volúmenes gestionados como los externos pueden ser desactivados. El esquema y el catálogo padre deben seguir existiendo.

Para encontrar el ID de un volumen descartado, usa SHOW VOLUMES DROPPED.

Si un volumen en vivo en el mismo esquema ya usa el nombre del volumen que quieres recuperar, renombra o elimina ese volumen primero con ALTER VOLUME o DROP VOLUME, y luego ejecuta UNDROP VOLUME.

Se recuperan los metadatos de los volúmenes, como los privilegios concedidos sobre el volumen y las etiquetas. Para un volumen gestionado, también se recuperan los archivos almacenados en el volumen.

Syntax

UNDROP VOLUME WITH ID volume_id

Parameter

  • volume_id

    Un STRING literal en forma de UUID que identifica el volumen eliminado, como se muestra con SHOW VOLUMES DROPPED.

No existe ningún formulario que recupere un volumen por nombre. Debes identificar el volumen por su ID.

Permissions

UNDROP VOLUME Requiere una de las siguientes características:

  • Tú posees, o tienes MANAGE en, el volumen, y tienes CREATE VOLUME y USE SCHEMA en el esquema, y USE CATALOG en el catálogo.
  • Tú eres propietario o tienes MANAGE en el esquema, y tienes USE CATALOG en el catálogo.
  • Tú eres propietario o tienes MANAGE el catálogo.
  • Tú eres el dueño de la metastore.

Además, debes tener los privilegios necesarios para crear el volumen que restauras. Por ejemplo, para restaurar un volumen externo, debes tener CREATE EXTERNAL VOLUME en la ubicación externa.

Después de ejecutar el comando, la propiedad pasa por defecto al propietario anterior del volumen.

Limitations

Solo puedes desactivar un volumen dentro de los 7 días siguientes a su caída. Tras el periodo de recuperación, el volumen se purga permanentemente y no puede recuperarse.

Ejemplos

-- 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
  • Última actualización el