DROP VOLUME

S’applique à :coché Databricks SQL coché Databricks Runtime 13.3 LTS et versions ultérieures coché Unity Catalog uniquement

Supprime le volume spécifié.

Note

Lorsque vous supprimez un volume managé, les fichiers de données sous-jacents ne sont pas supprimés immédiatement. Le catalogue Unity les conserve pendant 7 jours, puis les supprime définitivement (purge) dans les 48 heures. Cette période de rétention s’applique uniquement au nettoyage des fichiers de données et à la facturation du stockage. Elle ne rend pas le volume récupérable. Pour plus d’informations sur le cycle de vie et la facturation des fichiers de données, consultez le cycle de vie du stockage d’objets dans le catalogue Unity.

Si un volume externe est supprimé, les métadonnées relatives au volume sont supprimées du catalogue, mais les fichiers sous-jacents ne sont pas supprimés.

Permissions

Pour supprimer un volume, vous devez être le propriétaire du volume ou l’avoir MANAGE sur celui-ci. Vous devez également avoir USE CATALOG sur le catalogue parent et USE SCHEMA sur le schéma parent où réside le volume.

Selon la hiérarchie d’objets, les propriétaires du schéma parent ou du catalogue et des utilisateurs sur utilisant MANAGE cette opération peuvent également effectuer cette opération.

Avertissement

Impossible de récupérer un volume supprimé.

Syntaxe

DROP VOLUME [ IF EXISTS ] volume_name

Paramètre

  • S’IL EXISTE

    S’il est spécifié, aucune erreur n’est levée si le volume n’existe pas.

  • volume_name

    Nom du volume à supprimer. Si le volume est introuvable, Azure Databricks génère une erreur.

Exemples

– Drop a volume named 'my_volume'
> DROP VOLUME my_volume
  OK

– Drop a volume named `my_volume` under catalog `my_catalog` and schema `my_schema
> DROP VOLUME my_catalog.my_schema.my_volume
  OK

– The volume must exist
> DROP VOLUME my_volume
  Error

– Drop a volume named `my_volume` only if it exists
> DROP VOLUME IF EXISTS my_volume
  OK