// Referência de erro do PostgreSQL

PostgreSQL 42P07: relação já existe

CREATE TABLE, INDEX, VIEW ou SEQUENCE usou um nome que um objeto semelhante a tabela já possui nesse esquema.

SQLSTATE
42P07
Nome
duplicate_table
Categoria
Erro de sintaxe ou violação de regra de acesso
Mensagem de erro
relation "orders" already exists

O que significa

Tabelas, views, views materializadas, sequências, índices e tabelas externas compartilham um namespace por esquema. Criar qualquer um deles com um nome que já é usado no esquema falha com 42P07, mesmo que o objeto existente seja de um tipo diferente (um índice com o mesmo nome de uma tabela, por exemplo).

Executar novamente uma migração ou script de configuração é o gatilho usual.

Causas comuns

  • Um script de configuração ou migração que foi executado antes, parcialmente ou completamente.
  • Um índice com o mesmo nome de uma tabela, visão ou índice existente no esquema.
  • Duas migrações criando o mesmo objeto.
  • Uma tabela temporária que sobrou da mesma sessão.

Como corrigir

  1. Torne o script idempotente com IF NOT EXISTS.

    CREATE TABLE IF NOT EXISTS orders (id bigint PRIMARY KEY);
    CREATE INDEX IF NOT EXISTS orders_created_at_idx ON orders (created_at);
  2. Veja o que atualmente tem esse nome.

    SELECT n.nspname, c.relname, c.relkind
    FROM pg_class c JOIN pg_namespace n ON n.oid = c.relnamespace
    WHERE c.relname = 'orders';
  3. Se o objeto antigo deve ser substituído, exclua-o primeiro, após verificar que nada depende dele.

    DROP TABLE IF EXISTS orders_old;
    CREATE OR REPLACE VIEW order_summary AS SELECT 1 AS n;  -- views can be replaced in place

Reproduza com segurança

CREATE TEMP TABLE t (id int);
CREATE TEMP TABLE t (id int);  -- ERROR: relation "t" already exists

Erros relacionados

Mais erros de sintaxe ou violação de regra de acesso

O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com PostgreSQL no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o PostgreSQL e os outros bancos de dados que você usa.