Todos os produtos
Search
Central de documentação

Hologres:DROP TABLE

Última atualização: Sep 18, 2026

Este tópico descreve a sintaxe e o uso da instrução DROP TABLE.

Sintaxe

DROP TABLE [ IF EXISTS ] table_name [, ...];
Nota

DROP TABLE permite excluir várias tabelas em uma única instrução.

A tabela a seguir descreve os parâmetros.

Parâmetro

Descrição

IF EXISTS

  • Especifique IF EXISTS para garantir que a instrução seja executada com êxito mesmo que a tabela não exista.

  • Se você não especificar IF EXISTS, o sistema retorna o erro ERROR: table "non_exist_table" does not exist caso a tabela de destino não exista.

table_name

O nome da tabela que você deseja excluir.

Exemplo

A instrução a seguir exclui uma tabela chamada holo_test:

DROP TABLE holo_test;

Excluir uma tabela usando o HoloWeb

O HoloWeb oferece uma interface visual para excluir uma tabela sem a necessidade de escrever instruções SQL. Siga as etapas abaixo:

  1. Acesse o console do HoloWeb. Para mais informações, consulte Connect to HoloWeb and run SQL queries.

  2. Na barra de menu superior da página do HoloWeb, clique em Metadata Management.

  3. Na página Metadata Management, na lista Instances Connected à esquerda, clique com o botão direito do mouse na tabela que deseja excluir e selecione Delete Table.

  4. Na caixa de diálogo Delete Table, clique em OK.

Perguntas frequentes

  • Problema

    A operação falha com o seguinte erro: ERROR: cannot drop table xxx because other objects depend on it. Detail: view xxx depends on table xxx. Hint: Use DROP ... CASCADE to drop the dependent objects too..

  • Possível causa

    Não é possível excluir a tabela porque uma view depende dela.

  • Solução

    Execute a seguinte instrução para excluir em cascata. Isso remove a tabela e todos os objetos dependentes, como views.

    DROP TABLE [ IF EXISTS ] <table_name> [, ...] CASCADE;