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