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 tabulka. Pokud tabulka neexistuje, vyvolá se výjimka.
Pokud chcete odstranit tabulku, musíte být jejím 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 zadáno, není vyvolán žádná TABLE_OR_VIEW_NOT_FOUND chyba, pokud tabulka neexistuje.
-
Název tabulky, která se má vynechat. Název nesmí obsahovat dočasnou specifikaci. Pokud tabulku nenajdete, Azure Databricks vyvolá TABLE_OR_VIEW_NOT_FOUND chybu.
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;