DROP CATALOG

Van toepassing op: Databricks SQL Databricks Runtime 10.4 LTS en hoger 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.

  Opmerking

  In Unity Catalog verwijdert u een catalogus met behulp van CASCADE voorlopig verwijderen van de catalogus en de onderliggende objecten. Gegevensbestanden voor beheerde tabellen en volumes worden bewaard om een herstelvenster van 7 dagen mogelijk te maken. Nadat het herstelvenster is beëindigd, worden de gegevensbestanden binnen 48 uur definitief verwijderd (verwijderd). Bestanden voor externe tabellen en externe volumes worden niet verwijderd. Zie de levenscyclus van objectopslag in Unity Catalog voor meer informatie.

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;

Verwante artikelen:

• CREATE CATALOG
• DESCRIBE CATALOG
• SHOW CATALOGS
• Levenscyclus van objectopslag in Unity Catalog