Delen via

DROP CATALOG

  • Artikel

Van toepassing op:aangevinkt Databricks SQL aangevinkt Databricks Runtime 10.4 LTS en hoger aangevinkt Unity Catalog uitsluitend

Laat een catalogvallen. Er wordt een uitzondering gegenereerd als de catalog niet bestaat in de metastore. Als u een catalog wilt verwijderen, moet u de MANAGE bevoegdheid hebben voor de catalog of de eigenaar ervan zijn.

Syntaxis

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

Parameters

  • INDIEN AANWEZIG

    Indien opgegeven, wordt er geen uitzondering gegenereerd wanneer de catalog niet bestaat.

  • catalog_name:

    De naam van een bestaand catalog-item in de metastore. Als de naam niet bestaat, wordt er een uitzondering gegenereerd.

  • BEPERKEN

    Indien opgegeven, beperkt u het verwijderen van een niet-lege catalog. Standaard ingeschakeld.

  • CASCADE

    Indien opgegeven, worden alle bijbehorende databases (schema's) en de objecten daarin recursief verwijderd. In Unity Catalog, het laten vallen van een catalog met behulp van CASCADE zacht verwijdert tables: beheerde table-bestanden worden na 30 dagen opgeschoond, maar externe bestanden worden niet verwijderd.

Voorbeelden

-- 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;