// Referencia de errores de PostgreSQL

PostgreSQL 42P07: la relación ya existe

CREATE TABLE, INDEX, VIEW o SEQUENCE usó un nombre que un objeto tipo tabla ya tiene en ese esquema.

SQLSTATE
42P07
Nombre
duplicate_table
Categoría
Error de sintaxis o violación de regla de acceso
Mensaje de error
relation "orders" already exists

Qué significa

Tablas, vistas, vistas materializadas, secuencias, índices y tablas externas comparten un mismo espacio de nombres por esquema: crear cualquiera de estos objetos con un nombre ya usado en el esquema falla con 42P07, aunque el objeto existente sea de otro tipo (por ejemplo, un índice con el nombre de una tabla).

Volver a ejecutar una migración o un script de configuración es el desencadenante habitual.

Causas comunes

  • Un script de configuración o migración que ya se ejecutó antes, en parte o por completo.
  • Un índice con el mismo nombre que una tabla, vista o índice existente en el esquema.
  • Dos migraciones que crean el mismo objeto.
  • Una tabla temporal que quedó en la misma sesión.

Cómo solucionarlo

  1. Haz que el script sea idempotente con 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. Mira qué objeto usa ahora ese nombre.

    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. Si se debe reemplazar el objeto antiguo, elimínalo primero, después de verificar que nada dependa de él.

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

Reprodúcelo de forma segura

CREATE TEMP TABLE t (id int);
CREATE TEMP TABLE t (id int);  -- ERROR: relation "t" 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.