UNDROP VOLUME

S’applique à :coché oui Databricks SQL coché oui Databricks Runtime 19.11 et supérieur coché oui uniquement Unity Catalogue

La UNDROP VOLUME commande récupère un volume abandonné dans le catalogue Unity par son identifiant de volume. Utilisez-le pour restaurer un volume qui a été accidentellement perdu. Vous pouvez récupérer un volume perdu pendant 7 jours après la chute.

La restauration d’un volume est une opération de métadonnées, de sorte que les volumes gérés et externes peuvent être détournés. Le schéma parent et le catalogue doivent toujours exister.

Pour trouver l’identifiant d’un volume abandonné, utilisez SHOW VOLUMES DROPPED.

Si un volume live dans le même schéma utilise déjà le nom du volume que vous souhaitez récupérer, renommez ou supprimez ce volume d’abord avec ALTER VOLUME ou DROP VOLUME, puis exécutez UNDROP VOLUME.

Les métadonnées de volume, telles que les privilèges accordés sur le volume et les tags, sont récupérées. Pour un volume géré, les fichiers stockés dans le volume sont également récupérés.

Syntax

UNDROP VOLUME WITH ID volume_id

Parameter

  • volume_id

    Un littéral sous forme d’UUID qui identifie le volume supprimé, tel qu’affiché STRING par SHOW VOLUMES DROPPED.

Il n’existe aucun formulaire qui récupère un volume nommé. Vous devez identifier le volume à son ID.

Permissions

UNDROP VOLUME Nécessite l’un des éléments suivants :

  • Vous possédez, ou avez MANAGE sur, le volume, et vous avez CREATE VOLUME sur USE SCHEMA le schéma, et USE CATALOG sur le catalogue.
  • Vous possédez, ou avez MANAGE dessus, le schéma, et vous avez USE CATALOG sur le catalogue.
  • Vous possédez, ou avez MANAGE un sur le catalogue.
  • Vous possédez le Metastore.

De plus, vous devez disposer des privilèges nécessaires pour créer le volume que vous restaurez. Par exemple, pour restaurer un volume externe, il faut avoir CREATE EXTERNAL VOLUME sur l’emplacement externe.

Après l’exécution de la commande, la propriété revient par défaut au propriétaire précédent du volume.

Limitations

Vous ne pouvez déverrouiller un volume que dans les 7 jours suivant sa suppression. Après la période de récupération, le volume est définitivement purgé et ne peut plus être récupéré.

Exemples

-- 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
  • Dernière mise à jour :