Freigeben über


DROP CATALOG

Gilt für: Häkchen ja Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime 10.4 LTS und höher Häkchen gesetzt ja Nur Unity Catalog

Löscht einen Katalog. Wenn der Katalog im Metastore nicht vorhanden ist, wird eine Ausnahme ausgelöst. Um einen Katalog abzulegen, müssen Sie dessen Besitzer sein.

Syntax

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

Parameter

  • IF EXISTS

    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.

  • RESTRICT

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

  • CASCADE

    Wenn angegeben, werden alle zugeordneten Datenbanken (Schemas) und die darin enthaltenen Objekte rekursiv abgelegt. In Unity Catalog werden Tabellen beim Ablegen eines Katalogs mithilfe von CASCADE vorläufig gelöscht: Verwaltete Tabellendateien werden nach 30 Tagen bereinigt. Externe Dateien werden dagegen 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;