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
Katalog Unity obsługuje polecenie UNDROP TABLE umożliwiające odzyskanie usuniętych tabel zarządzanych w ciągu 7 dni. Po upływie 7 dni dane źródłowe są oznaczone do usunięcia z dzierżawy chmury podczas zwykłych operacji konserwacji tabel.
Składnia
DROP TABLE [ IF EXISTS ] table_name
Parametr
JEŚLI ISTNIEJE
Jeśli wskazano, nie zostanie zgłoszony błąd TABLE_OR_VIEW_NOT_FOUND, gdy tabela nie istnieje.
-
Nazwa tabeli do usunięcia. Nazwa nie może zawierać specyfikacji czasowej ani specyfikacji opcji. Jeśli nie można odnaleźć tabeli, usługa Azure Databricks zgłosi 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;