DROP TABLE
Область применения: Databricks SQL Databricks Runtime
Удаляет таблицу и связанный с этой таблицей каталог из файловой системы, если таблица не является таблицей EXTERNAL
. Если таблица не существует, создается исключение.
Чтобы удалить таблицу, необходимо быть ее владельцем или владельцем схемы, каталога или хранилища метаданных, в которой находится таблица.
Для внешней таблицы удаляются только связанные с ней метаданные из схемы хранилища метаданных.
Все ограничения внешнего ключа, ссылающиеся на таблицу, также удаляются.
Если таблица кэшируется, эта команда отменяет кэширование для таблицы и всех ее зависимых объектов.
Примечание.
При удалении управляемой таблицы из каталога Unity базовые данные удаляются из вашего облачного клиента в течение 30 дней.
Синтаксис
DROP TABLE [ IF EXISTS ] table_name
Параметр
IF EXISTS
Если задано, ошибка TABLE_OR_VIEW_NOT_FOUND возникает, если таблица не существует.
-
Имя таблицы, необходимой для удаления. Имя не должно включать темпоральную спецификацию или спецификацию параметров. Если не удается найти таблицу Azure Databricks, возникает ошибка TABLE_OR_VIEW_NOT_FOUND .
Примеры
-- 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;