Sdílet prostřednictvím

DROP CATALOG

  • Článek

platí pro:zaškrtnuto Ano Databricks SQL zaškrtnuto Ano Databricks Runtime 10.4 LTS a vyšší zaškrtnuto Ano Unity pouze Catalog

Zahodí catalog. Pokud catalog v metastoru neexistuje, vyvolá se výjimka. Pokud chcete catalog odstranit, musíte mít oprávnění MANAGE k catalog anebo být jeho vlastníkem.

Syntaxe

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

Parameters

  • POKUD EXISTUJE

    Pokud je zadáno, žádná výjimka není vyvolána, když catalog neexistuje.

  • catalog_name:

    Název existujícího catalog v metastoru. Pokud název neexistuje, vyvolá se výjimka.

  • OMEZIT

    Pokud je zadáno, omezí vyřazení neprázdné catalog. Ve výchozím nastavení povolena.

  • KASKÁDA

    Pokud je zadáno, zahodí všechny přidružené databáze (schémata) a objekty v nich rekurzivně. V CatalogUnity se odstranění catalog pomocí CASCADE obnovitelného odstranění tables: spravované soubory table se vyčistí po 30 dnech, ale externí soubory se neodstraní.

Příklady

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