// Referencia de errores de PostgreSQL

PostgreSQL 42830: clave foránea no válida

Una clave foránea apunta a columnas que no están cubiertas por una clave primaria o restricción única en la tabla referenciada.

SQLSTATE
42830
Nombre
invalid_foreign_key
Categoría
Error de sintaxis o violación de regla de acceso
Mensaje de error
there is no unique constraint matching given keys for referenced table "customers"

Qué significa

Una clave foránea debe referenciar columnas que estén garantizadas como únicas en la tabla padre, mediante su clave primaria o una UNIQUE restricción (o un índice único sin un predicado) exactamente en esas columnas. De lo contrario, PostgreSQL no puede determinar a qué fila padre se refiere una fila hija, y la creación de la clave foránea falla con 42830.

Las columnas deben coincidir como un conjunto: una restricción única en (tenant_id, id) no permite que una clave foránea haga referencia a id por sí sola.

Causas comunes

  • La columna referenciada no tiene ninguna clave primaria ni restricción única.
  • La clave foránea hace referencia a un subconjunto o superconjunto de las columnas de la restricción única.
  • El índice único de la tabla padre es parcial (tiene una WHERE cláusula), lo cual no puede respaldar una clave foránea.

Cómo solucionarlo

  1. Añade una clave primaria o una restricción única en las columnas referenciadas, luego crea la clave foránea.

    ALTER TABLE customers ADD CONSTRAINT customers_email_key UNIQUE (email);
    ALTER TABLE orders ADD FOREIGN KEY (customer_email) REFERENCES customers (email);
  2. O referencia la clave existente, usando la misma lista de columnas.

    ALTER TABLE orders
        ADD FOREIGN KEY (tenant_id, customer_id) REFERENCES customers (tenant_id, id);

Reprodúcelo de forma segura

CREATE TEMP TABLE p (id int);
CREATE TEMP TABLE c (p_id int REFERENCES p (id));  -- ERROR: there is no unique constraint matching given keys for referenced table "p"

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.