Freigeben über

DROP VOLUME

  • Artikel

Gilt für:Häkchen ja Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime 13.3 LTS und höher durch Häkchen mit „Ja“ markiert Nur Unity Catalog

Löscht das angegebene Volume.

Wenn Sie ein verwaltetes Volume löschen, werden die auf diesem Volume gespeicherten Dateien ebenfalls innerhalb von 30 Tagen aus Ihrem Cloudmandanten gelöscht.

Wenn ein externes Volume gelöscht wird, werden die Metadaten zum Volume aus dem Katalog entfernt, aber die zugrunde liegenden Dateien werden nicht gelöscht.

Um ein Volume zu löschen, müssen Sie über das MANAGE-Privileg für das Volume verfügen, dessen Besitzer sein oder der Besitzer des Schemas, Katalogs oder Metaspeichers sein, in dem das Volume enthalten ist.

Syntax

DROP VOLUME [ IF EXISTS ] volume_name

Parameter

  • IF EXISTS

    Wird dieser Parameter angegeben, wird kein Fehler ausgelöst, wenn das Volume nicht vorhanden ist.

  • volume_name

    Der Name des zu verwerfenden Volumes. Wenn das Volume nicht gefunden wird, löst Azure Databricks einen Fehler aus.

Beispiele

– 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