PostgreSQL 23503: violación de restricción de clave foránea
Una fila hace referencia a una clave padre que no existe, o eliminaste o cambiaste una fila padre a la que las filas hijas aún hacen referencia.
- SQLSTATE
23503- Nombre
foreign_key_violation
Qué significa
Una clave foránea indica que cada valor de la columna hija debe existir en la columna referenciada (principal). PostgreSQL genera el error 23503 en dos casos: cuando insertas o actualizas una fila hija cuya clave no tiene padre (is not present in table), y cuando eliminas o actualizas una fila padre a la que aún apuntan filas hijas (is still referenced from table).
La DETAIL la línea proporciona el valor de la clave y la otra tabla, para que sepas qué filas revisar.
Causas comunes
- Insertar filas hijas antes de las filas padre, por ejemplo al cargar
ordersantescustomers. - Un error tipográfico o un id obsoleto en la fila hija.
- Eliminar una fila padre que todavía tiene hijos, sin
ON DELETE CASCADEoSET NULLen la clave foránea. - Actualizar la clave primaria de un padre mientras los hijos hacen referencia al valor antiguo.
- Dos transacciones: una inserta un hijo para un padre que otra acaba de eliminar.
Cómo solucionarlo
-
Encontrar el padre que falta o los hijos restantes.
SELECT * FROM customers WHERE id = 42; SELECT * FROM orders WHERE customer_id = 42;
-
Insertar primero los padres, o cargar ambas tablas en una sola transacción con la restricción diferida (debe declararse
DEFERRABLE).ALTER TABLE orders ALTER CONSTRAINT orders_customer_id_fkey DEFERRABLE INITIALLY IMMEDIATE; BEGIN; SET CONSTRAINTS orders_customer_id_fkey DEFERRED; INSERT INTO orders (id, customer_id) VALUES (1, 42); INSERT INTO customers (id, name) VALUES (42, 'Ada'); COMMIT; -- checked here
-
Al eliminar un padre, elimina o reasigna primero a sus hijos, o cambia la regla de eliminación de la clave foránea si eso es lo que quieres.
ALTER TABLE orders DROP CONSTRAINT orders_customer_id_fkey, ADD CONSTRAINT orders_customer_id_fkey FOREIGN KEY (customer_id) REFERENCES customers (id) ON DELETE CASCADE; -
Encuentra los huérfanos antes de añadir una clave foránea a datos existentes.
SELECT o.* FROM orders o LEFT JOIN customers c ON c.id = o.customer_id WHERE o.customer_id IS NOT NULL AND c.id IS NULL;
Reprodúcelo de forma segura
CREATE TEMP TABLE p (id int PRIMARY KEY); CREATE TEMP TABLE c (p_id int REFERENCES p (id)); INSERT INTO c VALUES (1); -- ERROR: ... violates foreign key constraint "c_p_id_fkey"
Errores relacionados
23505clave duplicada viola la restricción única23502valor nulo viola la restricción de no nulo42830clave foránea no válida2BP01aún existen objetos dependientes547SQL Server: La instrucción entró en conflicto con una restricción1452MySQL: fallo de clave foránea: no se puede añadir la fila hija1451MySQL: fallo de clave foránea: no se puede eliminar la fila padreORA-02291Oracle: restricción de integridad violada - no hay clave principalORA-02292Oracle: restricción de integridad violada - se encontró un registro hijoSQLITE_CONSTRAINT_FOREIGNKEYSQLite: falló la restricción FOREIGN KEY
Más errores de violación de restricciones de integridad
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.
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.