DROP SCHEMA
Dotyczy: Databricks SQL
Databricks Runtime
Usuwa schemat i usuwa katalog skojarzony ze schematem z systemu plików. Wyjątek jest zgłaszany, jeśli schemat nie istnieje w systemie. Aby usunąć schemat, musisz posiadać uprawnienia MANAGE
do schematu 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 ]
Parametry
JEŚLI ISTNIEJE
Jeśli to określono, nie zostanie zgłoszony wyjątek, gdy schemat nie istnieje.
-
Nazwa istniejących schematów w systemie. Jeśli nazwa nie istnieje, zostanie zgłoszony wyjątek.
OGRANICZAĆ
Jeśli jest określone, ogranicza usuwanie niepustego schematu i jest włączone domyślnie.
KASKADA
Jeśli zostanie określone, usuń wszystkie skojarzone tabele i funkcje rekursywnie. W katalogu Unity, usunięcie schematu przy użyciu
CASCADE
skutkuje miękkim usunięciem tabel: pliki tabel zarządzanych zostaną usunięte po 30 dniach, ale pliki zewnętrzne nie zostaną usunięte. Ostrzeżenie! Jeśli schemat jest zarządzany przez magazyn metadanych programu Hive na poziomie obszaru roboczego, porzucanie schematu przy użyciuCASCADE
cyklicznie usuwa wszystkie pliki w określonej lokalizacji, niezależnie od typu tabeli (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;