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 für 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 löschen zu können, müssen Sie deren Besitzer*in oder Besitzer*in des Schemas, Katalogs oder Metastores sein, in dem sich das Volume befindet.

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