DROP TABLE
Dotyczy: Databricks SQL
Databricks Runtime
Usuwa table i usuwa katalog skojarzony z table z systemu plików, jeśli table nie jest EXTERNAL
table. Wyjątek jest zgłaszany, jeśli table nie istnieje.
Aby usunąć table, musisz mieć uprawnienia MANAGE
na table, być jego właścicielem lub właścicielem schema, cataloglub magazynu metadanych, w którym znajduje się table.
W przypadku zewnętrznego table, z metastore schemausuwane są tylko powiązane informacje o metadanych.
Wszelkie ograniczenia klucza obcego odwołujące się do table również są porzucane.
Jeśli table jest buforowana, polecenie usuwa table i wszystkie jego zależności.
Uwaga
Gdy zarządzany table zostanie usunięty z Catalog, jego bazowe dane zostaną usunięte z zasobów twojego wynajmującego chmury w ciągu 30 dni.
Składnia
DROP TABLE [ IF EXISTS ] table_name
Parametr
JEŚLI ISTNIEJE
Jeśli zostanie określono, żaden błąd TABLE_OR_VIEW_NOT_FOUND nie zostanie zgłoszony, gdy table nie istnieje.
-
Nazwa table, która ma zostać porzucona. Nazwa nie może zawierać specyfikacji czasowej ani specyfikacji opcji. Jeśli nie można odnaleźć table, Azure Databricks zgłasza błąd TABLE_OR_VIEW_NOT_FOUND.
Przykłady
-- 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;