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 Anopouze katalog Unity.

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

Syntaxe

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

Parametry

  • POKUD EXISTUJE

    Pokud je zadáno, není vyvolána žádná výjimka, a to i když katalog neexistuje.

  • catalog_name:

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

  • OMEZIT

    Pokud je zadaný, omezí vyřazení neprázdného katalogu. 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 katalogu Unity se smazání katalogu pomocí CASCADE, což měkce odstraní tabulky: soubory spravovaných tabulek budou odstraněny 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;