DROP VOLUME

  • [アーティクル]

適用対象:check marked yes Databricks SQL Databricks Runtime 13.3 LTS 以上 Unity Catalog のみ

指定されたボリュームを削除します。

マネージド ボリュームを削除すると、このボリュームに格納されているファイルも 30 日以内にクラウド テナントから削除されます。

外部ボリュームがドロップされると、ボリュームに関するメタデータはカタログから削除されますが、基になるファイルは削除されません。

ボリュームをドロップするには、その所有者であるか、ボリュームが存在するスキーマ、カタログ、またはメタストアの所有者である必要があります。

構文

DROP VOLUME [ IF EXISTS ] volume_name

パラメーター

  • IF EXISTS

    指定した場合、ボリュームがなくてもエラーがスローされません。

  • volume_name

    ドロップするボリュームの名前。 ボリュームが見つからない場合、Azure Databricks によってエラーが発生します。

例

– 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