DROP SCHEMA

適用対象: Databricks SQL Databricks Runtime

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

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

構文

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

パラメーター

• IF EXISTS

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

• schema_name

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

• 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;

関連記事

• CREATE SCHEMA
• DESCRIBE SCHEMA
• SHOW SCHEMAS