// PostgreSQL-Fehlerreferenz

PostgreSQL 42702: Spaltenreferenz ist mehrdeutig

Ein Spaltenname existiert in mehr als einer Tabelle der Abfrage (oder trifft auf eine PL/pgSQL-Variable zu), sodass PostgreSQL nicht erkennen kann, welchen du meinst.

SQLSTATE
42702
Name
ambiguous_column
Kategorie
Syntaxfehler oder Zugriffsregelverletzung
Fehlermeldung
column reference "id" is ambiguous
LINE 1: SELECT id FROM orders JOIN customers ON customers.id = orders.customer_id;
               ^

Was es bedeutet

Wenn zwei Tabellen in der FROM Klausel beide eine Spalte namens id, eine nicht qualifizierte id sich auf jede beziehen, sodass PostgreSQL die Abfrage mit 42702 ablehnt. Die Qualifizierung der Spalte mit dem Tabellennamen oder Alias beseitigt die Mehrdeutigkeit.

In PL/pgSQL-Funktionen tritt derselbe Fehler auf, wenn ein Spaltenname mit einem Variablen- oder Parameternamen übereinstimmt, zum Beispiel ein Funktionsparameter id der in einer Abfrage auf einer Tabelle verwendet wird, die ebenfalls id.

Häufige Ursachen

  • Verbundene Tabellen haben oft denselben Spaltennamen, etwa id, name, created_at oder status.
  • USING und NATURAL Joins fügen nur die Join-Spalten zusammen; andere gemeinsame Namen bleiben mehrdeutig.
  • In PL/pgSQL hat ein Parameter oder eine Variable denselben Namen wie eine Spalte, einschließlich RETURNS TABLE Ausgabespalten.

Wie du es behebst

  1. Qualifiziere die Spalte mit ihrer Tabelle oder ihrem Alias.

    SELECT o.id, c.name
    FROM orders o
    JOIN customers c ON c.id = o.customer_id;
  2. In PL/pgSQL gib Parametern ein Präfix, oder qualifiziere sie mit dem Funktionsnamen.

    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. Oder sag PL/pgSQL, dass es die Spalte bevorzugen soll: füge #variable_conflict use_column an den Anfang des Funktionskörpers hinzu.

Sicher reproduzieren

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

Zugehörige Fehler

Weitere Syntaxfehler oder Verletzungen von Zugriffsregeln

Der Code und der Meldungstext stammen aus der PostgreSQL-Dokumentation, Anhang A: PostgreSQL-Fehlercodes. Durchstöbere die vollständige PostgreSQL-Fehlerliste oder Jeden Datenbankfehler durchsuchen.

// weniger Fehler, schnellere Korrekturen

Arbeiten mit PostgreSQL in SQLly

Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für PostgreSQL und die anderen Datenbanken, mit denen du arbeitest.