// Referencia de errores de PostgreSQL

PostgreSQL 42P10: referencia de columna no válida

Con mayor frecuencia, un objetivo ON CONFLICT que no coincide con ningún índice único, o ORDER BY con SELECT DISTINCT en una columna que no se selecciona.

SQLSTATE
42P10
Nombre
invalid_column_reference
Categoría
Error de sintaxis o violación de regla de acceso
Mensaje de error
there is no unique or exclusion constraint matching the ON CONFLICT specification

Qué significa

42P10 (invalid_column_reference) se genera cuando una lista de columnas hace referencia a columnas de un modo que la instrucción no permite. Los dos casos más comunes:

INSERT ... ON CONFLICT (cols) necesita un índice único o una restricción exactamente en esas columnas (o una restricción de exclusión), para que PostgreSQL sepa qué cuenta como conflicto. Y con SELECT DISTINCT, cada ORDER BY expresión debe aparecer en la lista de selección: for SELECT DISTINCT, ORDER BY expressions must appear in select list.

Causas comunes

  • ON CONFLICT (email) en una tabla sin índice único en email, o con un índice único en lower(email) o un conjunto de columnas distinto.
  • Un índice único parcial, que ON CONFLICT solo se usa cuando la instrucción repite su WHERE predicado.
  • SELECT DISTINCT a FROM t ORDER BY b.

Cómo solucionarlo

  1. Crea el índice único que defina un conflicto, o nombra el objetivo del conflicto para que coincida con el existente.

    CREATE UNIQUE INDEX users_email_key ON users (email);
    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada')
    ON CONFLICT (email) DO UPDATE SET name = EXCLUDED.name;
  2. Para un índice de expresión o parcial, repite la expresión o el predicado en el objetivo de conflicto.

    CREATE UNIQUE INDEX users_email_lower_key ON users (lower(email));
    INSERT INTO users (email) VALUES ('[email protected]')
    ON CONFLICT ((lower(email))) DO NOTHING;
  3. Con DISTINCT, elige la columna por la que ordenar, o usa DISTINCT ON.

    SELECT DISTINCT customer_id, created_at FROM orders ORDER BY created_at;
    -- or one row per customer, newest first:
    SELECT DISTINCT ON (customer_id) customer_id, created_at
    FROM orders ORDER BY customer_id, created_at DESC;

Reprodúcelo de forma segura

CREATE TEMP TABLE u (email text);
INSERT INTO u VALUES ('a') ON CONFLICT (email) DO NOTHING;  -- ERROR: there is no unique or exclusion constraint matching the ON CONFLICT specification

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.