Udostępnij za pośrednictwem

DROP SCHEMA

  • Artykuł

Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime

Upuszcza schema i usuwa katalog skojarzony z schema z systemu plików. Wyjątek jest rzucony, jeśli schema nie istnieje w systemie. Aby usunąć schema, musisz mieć uprawnienia MANAGE do schema lub być jego właścicielem.

Chociaż użycie SCHEMA elementów i DATABASE jest wymienne, SCHEMA jest preferowane.

Składnia

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

Parameters

  • JEŚLI ISTNIEJE

    Jeśli zostanie to określone, nie zostanie zgłoszony wyjątek, gdy schema nie istnieje.

  • schema_name

    Nazwa istniejących schematów w systemie. Jeśli nazwa nie istnieje, zostanie zgłoszony wyjątek.

  • OGRANICZAĆ

    Jeśli określono, ogranicza usuwanie niepustego schema i jest to domyślnie włączone.

  • KASKADA

    Jeśli określono, usuwa wszystkie powiązane tables i funkcje rekursywnie. W Unity Catalog, porzucenie schema przy użyciu CASCADE powoduje miękkie usunięcie tables: zarządzane pliki table zostaną wyczyszczone po 30 dniach, ale pliki zewnętrzne nie są usuwane. Ostrzeżenie! Jeśli schema jest zarządzana przez magazyn metadanych Hive na poziomie obszaru roboczego, usunięcie schema przy użyciu CASCADE w sposób rekursywny usuwa wszystkie pliki w określonej lokalizacji, niezależnie od typu table (zarządzanego lub zewnętrznego).

Przykłady

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