DROP SCHEMA

Gilt für:Grünes Häkchen für „Ja“ Databricks SQL Grünes Häkchen für „Ja“ Databricks Runtime

Löscht ein Schema und 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 über die Berechtigung MANAGE für das Schema verfügen oder in seinem Besitz 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

  • WENN EXISTIERT

    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.

  • EINSCHRÄNKEN

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

  • KASKADE

    Wird dieser Parameter angegeben, werden alle zugeordneten Tabellen und Funktionen rekursiv gelöscht.

    Hinweis

    Im Unity-Katalog löscht das Schema und seine untergeordneten Objekte, indem ein Schema mit CASCADE vorläufig gelöscht wird. Datendateien für verwaltete Tabellen und Volumes werden beibehalten, um ein 7-tägiges Wiederherstellungsfenster zu ermöglichen. Nach Beendigung des Wiederherstellungsfensters werden die Datendateien innerhalb von 48 Stunden endgültig gelöscht (gelöscht). Dateien für externe Tabellen und externe Volumes werden nicht gelöscht. Ausführliche Informationen finden Sie unter "Objektspeicherlebenszyklus" im Unity-Katalog.

    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;
  • Last updated on