DROP TABLE
Dotyczy:
Databricks SQL Databricks Runtime
Usuwa tabelę i usuwa katalog skojarzony z tabelą z systemu plików, jeśli tabela nie EXTERNAL jest tabelą. Jeśli tabela nie istnieje, zostanie zgłoszony wyjątek.
Aby usunąć tabelę, musisz mieć uprawnienia MANAGE w tabeli, być jego właścicielem lub właścicielem schematu, wykazu lub magazynu metadanych, w którym znajduje się tabela.
W przypadku tabeli zewnętrznej tylko skojarzone informacje o metadanych są usuwane ze schematu magazynu metadanych.
Wszelkie ograniczenia klucza obcego odwołujące się do tabeli również są porzucane.
Jeśli tabela jest buforowana, polecenie anuluje buforowanie tabeli i wszystkich jej zależności.
Uwaga
Gdy zarządzana tabela zostanie porzucona z wykazu aparatu Unity, jego bazowe dane zostaną usunięte z dzierżawy chmury w ciągu 30 dni.
Składnia
DROP TABLE [ IF EXISTS ] table_name
Parametr
JEŚLI ISTNIEJE
Jeśli zostanie określony, nie zostanie zgłoszony żaden błąd TABLE_OR_VIEW_NOT_FOUND , gdy tabela nie istnieje.
-
Nazwa tabeli, która ma zostać porzucona. Nazwa nie może zawierać specyfikacji czasowej ani specyfikacji opcji. Jeśli nie można odnaleźć tabeli usługi Azure Databricks, wystąpi 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;