Todos os produtos
Search
Central de documentação

MaxCompute:DROP TABLE

Última atualização: Sep 22, 2026

A instrução DROP TABLE exclui uma tabela não particionada ou particionada.

Notas de uso

  • Tenha cuidado ao excluir uma tabela. A restauração de uma tabela excluída só é possível se o backup e a restauração estiverem ativados no projeto e se a tabela estiver dentro do período de retenção de dados. A restauração exige a configuração do local backup.

  • A exclusão de uma tabela reduz o uso de armazenamento do projeto MaxCompute.

Sintaxe

DROP TABLE [IF EXISTS] <table_name>; 

Parâmetros

Parâmetro

Obrigatório

Descrição

IF EXISTS

Não

Sem o IF EXISTS, tentar excluir uma tabela inexistente retorna uma exceção. Com o IF EXISTS, a instrução é bem-sucedida mesmo que a tabela não exista.

table_name

Sim

O nome da tabela que será excluída.

Exemplos

-- Drop the sale_detail table. The statement succeeds regardless of whether the table exists.
DROP TABLE IF EXISTS sale_detail; 

Comandos relacionados

  • CREATE TABLE: crie uma tabela não particionada, particionada, externa ou clusterizada.

  • ALTER TABLE: Altera uma tabela.

  • TRUNCATE TABLE: Remove todas as linhas da tabela especificada.

  • DESC TABLE/VIEW: Descreve uma tabela interna, visualize, materialized visualize, tabela externa, clusterizada ou transacional.

  • SHOW: Mostra a instrução DDL de uma tabela, lista todas as tabelas e views de um projeto ou lista todas as partições de uma tabela particionada.