DROP TABLE
Aplica-se a:
Databricks SQL Databricks Runtime
Exclui a tabela e remove o diretório associado à tabela do sistema de arquivos se a tabela não estiver EXTERNAL tabela. Uma exceção é lançada se a tabela não existir.
Para eliminar uma tabela, tem de ter o privilégio de MANAGE sobre a tabela, ser o seu proprietário ou o proprietário do esquema, catálogo ou metastore em que a tabela reside.
No caso de uma tabela externa, apenas as informações de metadados associadas são removidas do esquema do metastore.
Quaisquer restrições de chave estrangeira que façam referência à tabela também são descartadas.
Se a tabela estiver armazenada em cache, o comando desarmazenará em cache a tabela e todos os seus dependentes.
Nota
Quando uma tabela gerenciada é retirada do Catálogo Unity, seus dados subjacentes são excluídos do locatário da nuvem dentro de 30 dias.
Sintaxe
DROP TABLE [ IF EXISTS ] table_name
Parâmetro
SE EXISTE
Se especificado, nenhum erro TABLE_OR_VIEW_NOT_FOUND é lançado quando a tabela não existe.
-
O nome da tabela a ser eliminada. O nome não deve incluir uma especificação temporal ou uma especificação de opções. Se a tabela não puder ser encontrada, o Azure Databricks gerará um erro TABLE_OR_VIEW_NOT_FOUND.
Exemplos
-- 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;