DROP CATALOG

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.

  • název katalogu:

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

    Note

    V katalogu Unity vyřazuje katalog pomocí obnovitelného CASCADE odstranění katalogu a jeho podřízených objektů. Datové soubory pro spravované tabulky a svazky se uchovávají, aby se umožnilo 7denní období obnovení. Po skončení okna obnovení se datové soubory trvale odstraní (vyprázdní) do 48 hodin. Soubory pro externí tabulky a externí svazky se neodstraní. Podrobnosti najdete v tématu Životní cyklus úložiště objektů v katalogu Unity.

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;