// Referência de erro do PostgreSQL

PostgreSQL 42710: objeto duplicado

Uma instrução CREATE usou um nome já usado por um papel, restrição, extensão, gatilho, tipo ou outro objeto que não seja tabela.

SQLSTATE
42710
Nome
duplicate_object
Categoria
Erro de sintaxe ou violação de regra de acesso
Mensagem de erro
role "app" already exists

O que significa

42710 (duplicate_object) é o erro de «já existe» para objetos que não sejam tabelas e outras relações (42P07), bancos de dados (42P04), esquemas (42P06) e funções (42723). Mensagens típicas são role "app" already exists, constraint "orders_pkey" for relation "orders" already exists, extension "pgcrypto" already exists e trigger "set_updated_at" for relation "orders" already exists.

Quase sempre significa que um script de configuração ou migração está sendo executado pela segunda vez.

Causas comuns

  • Reexecutando um script de configuração que cria papéis, extensões ou tipos.
  • Uma migração que tenta adicionar uma restrição ou um gatilho que uma migração anterior ou uma alteração manual já criou.
  • Restaurando um dump em um banco de dados ou cluster onde os objetos já existem.

Como corrigir

  1. Use IF NOT EXISTS onde o comando suporta isso.

    CREATE EXTENSION IF NOT EXISTS pgcrypto;
    CREATE TABLE IF NOT EXISTS t (id int);
  2. Funções, restrições e tipos não têm IF NOT EXISTS; verifique primeiro em um DO bloco.

    DO $$
    BEGIN
        IF NOT EXISTS (SELECT FROM pg_roles WHERE rolname = 'app') THEN
            CREATE ROLE app LOGIN;
        END IF;
    END;
    $$;
  3. Para gatilhos, substitua-os diretamente (PostgreSQL 14 ou posterior).

    CREATE OR REPLACE TRIGGER set_updated_at
        BEFORE UPDATE ON orders
        FOR EACH ROW EXECUTE FUNCTION touch_updated_at();

Reproduza com segurança

CREATE EXTENSION plpgsql;  -- ERROR: extension "plpgsql" 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.