DROP TABLE
Aplica-se a: SQL do Databricks Runtime do Databricks
Excluirá a tabela e removerá o diretório associado à tabela do sistema de arquivos se a tabela não for EXTERNAL
. Uma exceção será gerada se a tabela não existir.
Para remover uma tabela, você deve ser seu proprietário ou o proprietário do esquema, catálogo ou metastore no qual a tabela reside.
No caso de uma tabela externa, somente as informações de metadados associadas serão removidas do esquema do metastore.
Todas as restrições de chave estrangeira que fazem referência à tabela também são removidas.
Se a tabela for armazenada em cache, o comando cancelará esse armazenamento da tabela e de todos os seus dependentes.
Observação
Quando uma tabela gerenciada é removida do Unity Catalog, os dados subjacentes dela são excluídos do seu locatário de nuvem dentro de 30 dias.
Sintaxe
DROP TABLE [ IF EXISTS ] table_name
Parâmetro
IF EXISTS
Se especificado, o erro TABLE_OR_VIEW_NOT_FOUND será gerado quando a tabela não existir.
-
O nome da tabela a ser descartada. O nome não deve incluir uma especificação temporal. 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;