// Referencia de errores de PostgreSQL

PostgreSQL 42710: objeto duplicado

Una instrucción CREATE utilizó un nombre ya tomado por un rol, restricción, extensión, desencadenador, tipo u otro objeto que no sea tabla.

SQLSTATE
42710
Nombre
duplicate_object
Categoría
Error de sintaxis o violación de regla de acceso
Mensaje de error
role "app" already exists

Qué significa

42710 (duplicate_object) es el error de "ya existe" para objetos que no sean tablas y otras relaciones (42P07), bases de datos (42P04), esquemas (42P06) y funciones (42723). Los mensajes típicos son role "app" already exists, constraint "orders_pkey" for relation "orders" already exists, extension "pgcrypto" already exists y trigger "set_updated_at" for relation "orders" already exists.

Casi siempre significa que un script de configuración o migración se está ejecutando por segunda vez.

Causas comunes

  • Volver a ejecutar un script de configuración que crea roles, extensiones o tipos.
  • Una migración que añade una restricción o disparador que una migración anterior o un cambio manual ya añadió.
  • Restaurando un volcado en una base de datos o clúster donde los objetos ya existen.

Cómo solucionarlo

  1. Usar IF NOT EXISTS donde el comando lo soporta.

    CREATE EXTENSION IF NOT EXISTS pgcrypto;
    CREATE TABLE IF NOT EXISTS t (id int);
  2. Los roles, restricciones y tipos no tienen IF NOT EXISTS; revisa primero en un DO bloque.

    DO $$
    BEGIN
        IF NOT EXISTS (SELECT FROM pg_roles WHERE rolname = 'app') THEN
            CREATE ROLE app LOGIN;
        END IF;
    END;
    $$;
  3. Para los disparadores, reemplázalos en su lugar (PostgreSQL 14 y posteriores).

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

Reprodúcelo de forma segura

CREATE EXTENSION plpgsql;  -- ERROR: extension "plpgsql" already exists

Errores relacionados

Más errores de sintaxis o de violación de reglas de acceso

El código y el texto del mensaje son de documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL. Explora la lista completa de Lista de errores de PostgreSQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con PostgreSQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para PostgreSQL y las demás bases de datos que uses.