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 DET 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.

    Anmärkning

    Om du släpper en katalog i Unity Catalog med mjuk CASCADE borttagning tas katalogen och dess underordnade objekt bort. Datafiler för hanterade tabeller och volymer behålls för att möjliggöra ett 7-dagars återställningsfönster. När återställningsfönstret är slut tas datafilerna bort permanent (rensas) inom 48 timmar. Filer för externa tabeller och externa volymer tas inte bort. Mer information finns i Livscykeln för objektlagring i Unity Catalog.

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;