Dela via


DROP CATALOG

gäller för:kontrollera markerat ja Databricks SQL kontrollera markerat ja Databricks Runtime 10.4 LTS och senare kontrollera markerat ja Endast Unity Catalog

Släpper en katalog. Ett undantag utlöses om katalogen inte finns i metaarkivet. Om du vill ta bort en katalog måste du ha MANAGE behörighet för katalogen eller vara dess ägare.

Syntax

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

Parametrar

  • OM FINNS

    Om det anges utlöses inget undantag när katalogen inte finns.

  • catalog_name:

    Namnet på en befintlig katalog i metaarkivet. Om namnet inte finns genereras ett undantag.

  • BEGRÄNSA

    Om det anges, begränsa borttagning av en icke-tom katalog. Aktiverat som standard.

  • KASKAD

    Om du anger det släpper du alla associerade databaser (scheman) och objekten i dem rekursivt. I Unity Catalog rensas en katalog med CASCADE tabeller med mjuk borttagning: hanterade tabellfiler rensas efter 30 dagar, men externa filer tas inte bort.

Exempel

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