// Referencia de errores de PostgreSQL

PostgreSQL 42702: la referencia a la columna es ambigua

Un nombre de columna existe en más de una tabla de la consulta (o coincide con una variable de PL/pgSQL), por lo que PostgreSQL no puede determinar a cuál te refieres.

SQLSTATE
42702
Nombre
ambiguous_column
Categoría
Error de sintaxis o violación de regla de acceso
Mensaje de error
column reference "id" is ambiguous
LINE 1: SELECT id FROM orders JOIN customers ON customers.id = orders.customer_id;
               ^

Qué significa

Cuando dos tablas en la FROM cláusula tienen ambas una columna llamada id, un id no calificada podría referirse a cualquiera de las dos, por lo que PostgreSQL rechaza la consulta con 42702. Calificar la columna con el nombre de su tabla o alias elimina la ambigüedad.

En las funciones PL/pgSQL aparece el mismo error cuando el nombre de una columna coincide con el de una variable o parámetro, por ejemplo un parámetro de función id usado en una consulta sobre una tabla que también tiene id.

Causas comunes

  • Las tablas unidas comparten un nombre de columna, a menudo id, name, created_at o status.
  • USING y NATURAL las uniones combinan solo las columnas de unión; los demás nombres compartidos quedan ambiguos.
  • En PL/pgSQL, un parámetro o variable tiene el mismo nombre que una columna, incluyendo RETURNS TABLE columnas de salida.

Cómo solucionarlo

  1. Califica la columna con su tabla o su alias.

    SELECT o.id, c.name
    FROM orders o
    JOIN customers c ON c.id = o.customer_id;
  2. En PL/pgSQL, usa un prefijo en los parámetros o califícalos con el nombre de la función.

    CREATE FUNCTION order_total(p_id int) RETURNS numeric
    LANGUAGE plpgsql AS $$
    BEGIN
        RETURN (SELECT total FROM orders WHERE orders.id = p_id);
    END;
    $$;
  3. O indica a PL/pgSQL que prefiera la columna: agrega #variable_conflict use_column al principio del cuerpo de la función.

Reprodúcelo de forma segura

SELECT id FROM (VALUES (1)) a(id), (VALUES (2)) b(id);  -- ERROR: column reference "id" is ambiguous

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.