DROP SCHEMA

Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak 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.

Chociaż użycie SCHEMA i DATABASE jest zamienne, SCHEMA jest preferowane.

Permissions

Aby umieścić schemat w Unity Catalog, musisz mieć MANAGE uprawnienia do schematu lub być jego właścicielem, a także USE CATALOG na katalogu, w którym schemat się znajduje.

Zgodnie z hierarchią obiektów właściciel katalogu nadrzędnego i użytkowników z MANAGE wykazem nadrzędnym może również wykonać tę operację. Potrzebne uprawnienia użytkowania zależą od poziomu obiektu, na którym są własnością lub MANAGE. Zobacz Wymagania dotyczące uprawnień użytkowania dla MANAGE.

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.

  • schema_name

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

  • OGRANICZ

    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.

    Note

    W wykazie aparatu Unity porzucanie schematu przy użyciu CASCADE usuwania nietrwałego schematu i jego obiektów podrzędnych. Pliki danych dla zarządzanych tabel i woluminów są przechowywane w celu umożliwienia 7-dniowego okna odzyskiwania. Po zakończeniu okna odzyskiwania pliki danych zostaną trwale usunięte (przeczyszczone) w ciągu 48 godzin. Pliki tabel zewnętrznych i woluminów zewnętrznych nie są usuwane. Aby uzyskać szczegółowe informacje, zobacz Cykl życia magazynu obiektów w wykazie aparatu Unity.

    Ostrzeżenie! Jeśli schemat jest zarządzany przez magazyn metadanych programu Hive na poziomie obszaru roboczego, porzucanie schematu przy użyciu CASCADE 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;
  • Ostatnia aktualizacja o