DROP CATALOG
Dotyczy: Databricks SQL
Databricks Runtime 10.4 LTS i nowsze
tylko katalog Unity
Przerywa katalog. Wyjątek jest zgłaszany, jeśli wykaz nie istnieje w magazynie metadanych. Aby usunąć wykaz, musisz mieć uprawnienia MANAGE
w wykazie lub być jego właścicielem.
Składnia
DROP CATALOG [ IF EXISTS ] catalog_name [ RESTRICT | CASCADE ]
Parametry
JEŚLI ISTNIEJE
Jeśli zostanie określona taka opcja, nie zostanie zgłoszony żaden wyjątek, gdy katalog nie istnieje.
-
Nazwa istniejącego katalogu w magazynie metadanych. Jeśli nazwa nie istnieje, zostanie zgłoszony wyjątek.
OGRANICZ
Jeśli zostanie to określone, uniemożliwia usunięcie niepustego katalogu. Włączone domyślnie.
KASKADA
Jeśli zostanie określona taka opcja, usuwa wszystkie powiązane bazy danych (schematy) oraz obiekty w nich, rekursywnie. W katalogu Unity, usunięcie katalogu za pomocą
CASCADE
powoduje nietrwałe usunięcie tabel: pliki tabel zarządzanych zostaną usunięte po 30 dniach, ale pliki zewnętrzne nie zostaną usunięte.
Przykłady
-- 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;