DROP SCHEMA
Gilt für: Databricks SQL 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.
-
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 vonCASCADE
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;