DROP CATALOG

Gilt für:Grünes Häkchen für „Ja“ Databricks SQL Grünes Häkchen für „Ja“ Databricks Runtime 10.4 LTS und höher Grünes Häkchen für „Ja“ nur für Unity Catalog

Löscht einen Katalog. Wenn der Katalog im Metastore nicht vorhanden ist, wird eine Ausnahme ausgelöst. Zum Ablegen eines Katalogs müssen Sie über die MANAGE Berechtigung für den Katalog verfügen oder dessen Besitzer sein.

Syntax

DROP CATALOG [ IF EXISTS ] catalog_name [ RESTRICT | CASCADE ]

Parameter

  • WENN EXISTIERT

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

  • catalog_name:

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

  • EINSCHRÄNKEN

    Wenn angegeben, wird das Ablegen eines nicht leeren Katalogs eingeschränkt. Standardmäßig aktiviert.

  • KASKADE

    Wenn angegeben, werden alle zugeordneten Datenbanken (Schemas) und die darin enthaltenen Objekte rekursiv abgelegt.

    Note

    Im Unity-Katalog löscht das Ablegen eines Katalogs mit CASCADE vorläufigen Löschungen den Katalog und seine untergeordneten Objekte. 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.

Beispiele

-- Create a `vaccine` catalog
> CREATE CATALOG vaccine COMMENT 'This catalog is used to maintain information about vaccines';

-- Drop the catalog and its schemas
> DROP CATALOG vaccine CASCADE;

-- Drop the catalog using IF EXISTS and only if it is empty.
> DROP CATALOG IF EXISTS vaccine RESTRICT;
  • Last updated on