DROP TABLE
Platí pro: Databricks SQL
Databricks Runtime
Odstraní tabulku a odebere adresář přidružený k tabulce ze systému souborů, pokud tabulka není EXTERNAL
tabulce. Pokud tabulka neexistuje, vyvolá se výjimka.
Pokud chcete odstranit tabulku, musíte mít oprávnění k MANAGE
tabulky, být jeho vlastníkem nebo vlastníkem schématu, katalogu nebo metastoru, ve kterém se tabulka nachází.
V případě externí tabulky se ze schématu metastoru odeberou pouze přidružené informace o metadatech.
Všechna omezení cizího klíče odkazující na tabulku se také zahodí.
Pokud je tabulka uložena do mezipaměti, příkaz zruší mezipaměť tabulky a všechny její závislé položky.
Poznámka:
Když se spravovaná tabulka odstraní z katalogu Unity, její podkladová data se ze svého cloudového tenanta odstraní do 30 dnů.
Syntaxe
DROP TABLE [ IF EXISTS ] table_name
Parametr
POKUD EXISTUJE
Pokud je uvedeno, nedochází k vyvolání žádné TABLE_OR_VIEW_NOT_FOUND chyby, pokud tabulka neexistuje.
-
Název tabulky, která se má smazat. Název nesmí obsahovat dočasnou specifikaci ani specifikaci možností. Pokud se tabulka nenašla, Azure Databricks vyvolá chybu TABLE_OR_VIEW_NOT_FOUND.
Příklady
-- Assumes a table named `employeetable` exists.
> DROP TABLE employeetable;
-- Assumes a table named `employeetable` exists in the `userdb` schema
> DROP TABLE userdb.employeetable;
-- Assumes a table named `employeetable` does not exist.
-- Throws TABLE_OR_VIEW_NOT_FOUND
> DROP TABLE employeetable;
Error: TABLE_OR_VIEW_NOT_FOUND
-- Assumes a table named `employeetable` does not exist,Try with IF EXISTS
-- this time it will not throw exception
> DROP TABLE IF EXISTS employeetable;