ONUDROP VOLUME

Aplica-se a:assinalado Databricks SQL assinalado sim Databricks Runtime 19.11 e superiores assinalado sim apenas Unity Catalog

O UNDROP VOLUME comando recupera um volume eliminado no Unity Catalog pelo seu ID de volume. Use-o para restaurar um volume que caiu acidentalmente. Podes recuperar um volume perdido durante 7 dias após a queda.

Restaurar um volume é uma operação de metadados, pelo que tanto os volumes geridos como os externos podem ser retirados. O esquema pai e o catálogo devem continuar a existir.

Para encontrar o ID de um volume dropped, use SHOW VOLUMES DROPPED.

Se um volume ao vivo no mesmo esquema já usar o nome do volume que quer recuperar, renomeie ou elimine esse volume primeiro com ALTER VOLUME ou DROP VOLUME, depois execute UNDROP VOLUME.

Os metadados de volume, como privilégios concedidos ao volume e às etiquetas, são recuperados. Para um volume gerido, os ficheiros armazenados no volume também são recuperados.

Syntax

UNDROP VOLUME WITH ID volume_id

Parameter

  • volume_id

    Um STRING literal sob a forma de UUID que identifica o volume descartado, conforme exibido por SHOW VOLUMES DROPPED.

Não existe um formulário que recupere um volume pelo nome. Deve identificar o volume pelo seu ID.

Permissions

UNDROP VOLUME Requer um dos seguintes requisitos:

  • Tu possuis, ou tens MANAGE , o volume, e tens CREATE VOLUME e USE SCHEMA no esquema, e USE CATALOG no catálogo.
  • Tu possuis, ou tens MANAGE o esquema, e tens USE CATALOG no catálogo.
  • Tu possuis, ou tens MANAGE , o catálogo.
  • Tu és dono da metastore.

Além disso, deve ter os privilégios necessários para criar o volume que restaura. Por exemplo, para restaurar um volume externo, tem de ter CREATE EXTERNAL VOLUME na localização externa.

Após a execução do comando, a propriedade passa por defeito ao proprietário anterior do volume.

Limitations

Só podes desfazer um volume dentro de 7 dias após ter sido lançado. Após o período de recuperação, o volume é permanentemente purgado e não pode ser recuperado.

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
  • Última atualização a