DROP CATALOG

Platí pro:zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 10.4 LTS a vyšší zaškrtnutí označeného ano pouze katalog Unity

Zahodí katalog. Pokud katalog v metastoru neexistuje, vyvolá se výjimka. Pokud chcete katalog odstranit, musíte být jeho vlastníkem.

Syntaxe

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

Parametry

  • POKUD EXISTUJE

    Pokud je zadána, není vyvolán žádná výjimka, pokud 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ÁDY

    Pokud je zadáno, zahodí všechny přidružené databáze (schémata) a objekty v nich rekurzivně. V katalogu Unity se po uplynutí 30 dnů vymažou katalog pomocí CASCADE tabulek obnovitelného odstranění: spravované soubory tabulek se vyčistí, 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;