DROP SCHEMA

適用対象:「はい」のチェック マーク Databricks SQL 「はい」のチェック マーク Databricks Runtime

スキーマを削除し、スキーマに関連付けられているディレクトリをファイル システムから削除します。 スキーマがシステムに存在しない場合は、例外がスローされます。 スキーマをドロップするには、スキーマに対する MANAGE 権限を持っているか、その所有者である必要があります。

SCHEMA と DATABASE の使用は交換可能ですが、SCHEMA をお勧めします。

構文

DROP SCHEMA [ IF EXISTS ] schema_name [ RESTRICT | CASCADE ]

パラメーター

  • 存在する場合

    指定した場合、スキーマがなくても例外はスローされません。

  • schema_name

    システム内の既存のスキーマの名前。 名前が存在しない場合は、例外がスローされます。

  • 制限

    指定した場合、空でないスキーマの削除が制限されます。既定で有効になっています。

  • カスケード

    指定した場合、関連付けられているすべてのテーブルと関数が再帰的に削除されます。

    注

    Unity カタログで、 CASCADE を使用してスキーマを削除すると、スキーマとその子オブジェクトが論理的に削除されます。 マネージド テーブルとボリュームのデータ ファイルは、7 日間の復旧期間を可能にするために保持されます。 回復ウィンドウが終了すると、データ ファイルは 48 時間以内に完全に削除 (消去) されます。 外部テーブルと外部ボリュームのファイルは削除されません。 詳細については、 Unity カタログのオブジェクト ストレージライフサイクルを参照してください。

    警告! スキーマがワークスペース レベルの Hive メタストアによって管理されている場合、CASCADE を使用してスキーマを削除すると、テーブルの種類 (マネージドまたは外部) に関係なく、指定した場所にあるすべてのファイルが再帰的に削除されます。

例

-- Create `inventory_schema` Database
> CREATE SCHEMA inventory_schema COMMENT 'This schema is used to maintain Inventory';

-- Drop the schema and its tables
> DROP SCHEMA inventory_schema CASCADE;

-- Drop the schema using IF EXISTS
> DROP SCHEMA IF EXISTS inventory_schema CASCADE;
  • Last updated on