DROP SCHEMA

  • [アーティクル]

適用対象:check marked yes Databricks SQL check marked yes Databricks Runtime 9.1 以上

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

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;