Freigeben über


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. Im Unity-Katalog werden Beim Ablegen eines Katalogs mithilfe von CASCADE Tabellen vorläufig gelöscht: Verwaltete Tabellendateien werden innerhalb von 7 bis 30 Tagen bereinigt, externe Dateien werden jedoch nicht gelöscht.

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;