// Référence des erreurs PostgreSQL

PostgreSQL 42702 : la référence de colonne est ambiguë

Un nom de colonne existe dans plus d'une table de la requête (ou correspond à une variable PL/pgSQL), donc PostgreSQL ne peut pas savoir lequel vous voulez dire.

SQLSTATE
42702
Nom
ambiguous_column
Catégorie
Erreur de syntaxe ou violation de règle d'accès
Message d'erreur
column reference "id" is ambiguous
LINE 1: SELECT id FROM orders JOIN customers ON customers.id = orders.customer_id;
               ^

Ce que cela signifie

Lorsque deux tables dans la FROM clause ont toutes deux une colonne appelée id, une référence non qualifiée à id pourrait se référer à l'une ou l'autre, donc PostgreSQL refuse la requête avec le code 42702. Qualifier la colonne avec le nom de sa table ou son alias supprime l'ambiguïté.

Dans les fonctions PL/pgSQL, la même erreur apparaît quand le nom d'une colonne correspond à un nom de variable ou de paramètre, par exemple un paramètre de fonction id utilisé dans une requête sur une table qui a également id.

Causes courantes

  • Les tables jointes partagent un nom de colonne, souvent id, name, created_at ou status.
  • USING et NATURAL les jointures ne fusionnent que les colonnes de jointure ; les autres noms communs restent ambigus.
  • Dans PL/pgSQL, un paramètre ou une variable a le même nom qu'une colonne, y compris RETURNS TABLE colonnes de sortie.

Comment le corriger

  1. Qualifiez la colonne avec sa table ou son alias.

    SELECT o.id, c.name
    FROM orders o
    JOIN customers c ON c.id = o.customer_id;
  2. Dans PL/pgSQL, donnez aux paramètres un préfixe, ou qualifiez-les avec le nom de la fonction.

    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. Ou indiquez à PL/pgSQL de préférer la colonne : ajoutez #variable_conflict use_column en haut du corps de la fonction.

Reproduisez-le en toute sécurité

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

Erreurs liées

Plus d'erreurs de syntaxe ou de violation de règle d'accès

Le code et le texte du message sont issus de Documentation PostgreSQL, annexe A : Codes d’erreur PostgreSQL. Parcourir la liste complète Liste des erreurs PostgreSQL ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur PostgreSQL dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d'erreur clairs, pour PostgreSQL et les autres bases de données que vous utilisez.