// справочник ошибок PostgreSQL

PostgreSQL 42702: ссылка на столбец неоднозначна

Имя столбца встречается более чем в одной таблице запроса (или совпадает с переменной PL/pgSQL), поэтому PostgreSQL не может определить, какой именно вы имеете в виду.

SQLSTATE
42702
Имя
ambiguous_column
Категория
Ошибка синтаксиса или нарушение правила доступа
Сообщение об ошибке
column reference "id" is ambiguous
LINE 1: SELECT id FROM orders JOIN customers ON customers.id = orders.customer_id;
               ^

Что это значит

Когда в двух таблицах в FROM есть столбец с названием id, неуточнённый id может относиться к любому из них, поэтому PostgreSQL отклоняет запрос с кодом 42702. Указание столбца вместе с именем таблицы или псевдонимом снимает неоднозначность.

В функциях PL/pgSQL та же ошибка возникает, когда имя столбца совпадает с именем переменной или параметра, например, параметр функции id используется в запросе к таблице, которая также имеет id.

Распространённые причины

  • Объединённые таблицы имеют общее имя столбца, часто id, name, created_at или status.
  • USING и NATURAL соединение объединяет только столбцы соединения; остальные совпадающие имена остаются неоднозначными.
  • В PL/pgSQL параметр или переменная имеют то же имя, что и столбец, в том числе RETURNS TABLE столбцы вывода.

Как исправить

  1. Указывайте столбец через его таблицу или псевдоним.

    SELECT o.id, c.name
    FROM orders o
    JOIN customers c ON c.id = o.customer_id;
  2. В PL/pgSQL давайте параметрам префиксы или уточняйте их именем функции.

    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. Или скажите PL/pgSQL предпочитать столбец: добавьте #variable_conflict use_column в начало тела функции.

Безопасное воспроизведение

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

Связанные ошибки

Больше ошибок синтаксиса или нарушения правил доступа

Код и текст сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL. Смотрите весь Список ошибок PostgreSQL или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с PostgreSQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.