DROP SCHEMA

  • Artikel

Gilt für:durch Häkchen mit „Ja“ markiert Databricks SQL Häkchen bei ja Databricks Runtime

Löscht ein Schema und löscht das das zugeordnete Verzeichnis aus dem Dateisystem. Wenn das Schema nicht im System vorhanden ist, wird eine Ausnahme ausgelöst. Um ein Schema zu löschen, müssen Sie dessen Besitzer sein.

Auch wenn die Verwendung von SCHEMA und DATABASE austauschbar ist, sollte vorzugsweise SCHEMA verwendet werden.

Syntax

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

Parameter

  • IF EXISTS

    Wird dieser Parameter angegeben, wird keine Ausnahme ausgelöst, wenn das Schema nicht vorhanden ist.

  • schema_name

    Der Name eines vorhandenen Schemas im System. Wenn der Name nicht vorhanden ist, wird eine Ausnahme ausgelöst.

  • RESTRICT

    Wird dieser Parameter angegeben, wird das Löschen eines nicht leeren Schemas eingeschränkt (standardmäßig aktiviert).

  • CASCADE

    Wird dieser Parameter angegeben, werden alle zugeordneten Tabellen und Funktionen rekursiv gelöscht. In Unity Catalog werden Tabellen beim Löschen eines Schemas mithilfe von CASCADE vorläufig gelöscht: Verwaltete Tabellendateien werden nach 30 Tagen bereinigt. Externe Dateien werden dagegen nicht gelöscht. Warnung! Wenn das Schema vom Hive-Metastore auf Arbeitsbereichsebene verwaltet wird, führt das Löschen eines Schemas mithilfe von CASCADE dazu, dass alle Dateien am angegebenen Speicherort rekursiv gelöscht werden. Dies ist unabhängig vom Tabellentyp (verwaltet oder extern).

Beispiele

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