Delen via

DROP CATALOG

  • Artikel

Van toepassing op:gemarkeerd als ja Databricks SQL gemarkeerd als ja Databricks Runtime 10.4 LTS en hoger gemarkeerd als ja Unity Catalog alleen

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

Syntaxis

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

Parameterwaarden

  • ALS BESTAAT

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

  • catalogusnaam:

    De naam van een bestaande catalogus in de metastore. Als de naam niet bestaat, wordt er een uitzondering gegenereerd.

  • BEPERKEN

    Indien opgegeven, wordt het verwijderen van een niet-lege catalogus beperkt. Standaard ingeschakeld.

  • CASCADE

    Indien opgegeven, worden alle bijbehorende databases (schema's) en de objecten daarin recursief verwijderd. In Unity Catalog worden catalogi verwijderd met behulp van CASCADE, wat leidt tot het voorlopig verwijderen van tabellen: beheerde tabelbestanden worden na 30 dagen verwijderd, 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;