DROP SCHEMA
適用対象: Databricks SQL Databricks Runtime
スキーマを削除し、スキーマに関連付けられているディレクトリをファイル システムから削除します。 スキーマがシステムに存在しない場合は、例外がスローされます。 スキーマをドロップするには、その所有者である必要があります。
SCHEMA
と DATABASE
の使用は交換可能ですが、SCHEMA
をお勧めします。
構文
DROP SCHEMA [ IF EXISTS ] schema_name [ RESTRICT | CASCADE ]
パラメーター
IF EXISTS
指定した場合、スキーマがなくても例外がスローされません。
-
システム内の既存のスキーマの名前。 名前が存在しない場合は、例外がスローされます。
RESTRICT
指定した場合、空でないスキーマの削除が制限されます。既定で有効になっています。
CASCADE
指定した場合、関連付けられているすべてのテーブルと関数が再帰的に削除されます。 Unity Catalog では、
CASCADE
を使用してスキーマを削除すると、テーブルが論理削除されます。マネージド テーブル ファイルは 30 日後にクリーンアップされますが、外部ファイルは削除されません。 警告! スキーマがワークスペース レベルの 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;