DROP SCHEMA

Platí pro:zaškrtnuto ano Databricks SQL zaškrtnuto ano Databricks Runtime

Zahodí schéma a odstraní adresář přidružený ke schématu ze systému souborů. Pokud schéma v systému neexistuje, vyvolá se výjimka.

I když je používání SCHEMA a DATABASE je zaměnitelné, SCHEMA je upřednostňované.

Povolení

Pro zařazení schématu do Unity Catalog musíte mít MANAGE právo na schéma nebo být jeho vlastníkem, plus USE CATALOG na katalogu, kde se schéma nachází.

V hierarchii objektů může tuto operaci provést také vlastník nadřazeného katalogu a uživatelé s MANAGE nadřazeným katalogem.

Syntaxe

DROP SCHEMA [ IF EXISTS ] schema_name [ RESTRICT | CASCADE ]

Parametry

  • POKUD EXISTUJE

    Pokud je zadáno, není vyvolána žádná výjimka, pokud schéma neexistuje.

  • schema_name

    Název existujících schémat v systému. Pokud název neexistuje, vyvolá se výjimka.

  • OMEZIT

    Pokud je zadáno, omezí vyřazení neprázdného schématu a ve výchozím nastavení je povoleno.

  • KASKÁDA

    Pokud je zadáno, všechny přidružené tabulky a funkce rekurzivně zahodí.

    Note

    V katalogu Unity přetažení schématu pomocí obnovitelného CASCADE odstranění schématu 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.

    Upozornění! Pokud je schéma spravované metastorem Hive na úrovni pracovního prostoru, odstranění schématu pomocí CASCADE rekurzivně odstraní všechny soubory v zadaném umístění bez ohledu na typ tabulky (spravovaný nebo externí).

Příklady

-- Create `inventory_schema` Database
> CREATE SCHEMA inventory_schema COMMENT 'This schema is used to maintain Inventory';

-- Drop the schema and its tables
> DROP SCHEMA inventory_schema CASCADE;

-- Drop the schema using IF EXISTS
> DROP SCHEMA IF EXISTS inventory_schema CASCADE;