// Referência de erro do PostgreSQL

PostgreSQL 42702: referência de coluna é ambígua

Um nome de coluna existe em mais de uma tabela da consulta (ou corresponde a uma variável PL/pgSQL), então o PostgreSQL não consegue determinar a qual você se refere.

SQLSTATE
42702
Nome
ambiguous_column
Categoria
Erro de sintaxe ou violação de regra de acesso
Mensagem de erro
column reference "id" is ambiguous
LINE 1: SELECT id FROM orders JOIN customers ON customers.id = orders.customer_id;
               ^

O que significa

Quando duas tabelas na FROM cláusula têm uma coluna chamada id, uma id pode se referir a qualquer uma delas, então o PostgreSQL rejeita a consulta com 42702. Qualificar a coluna com o nome da tabela ou o alias remove a ambiguidade.

Em funções PL/pgSQL, o mesmo erro aparece quando o nome de uma coluna coincide com o nome de uma variável ou parâmetro, por exemplo, um parâmetro de função id usado em uma consulta em uma tabela que também possui id.

Causas comuns

  • Tabelas unidas compartilham um nome de coluna, frequentemente id, name, created_at ou status.
  • USING e NATURAL joins mesclam apenas as colunas de junção; outros nomes compartilhados permanecem ambíguos.
  • No PL/pgSQL, um parâmetro ou variável tem o mesmo nome de uma coluna, incluindo RETURNS TABLE colunas de saída.

Como corrigir

  1. Qualifique a coluna com sua tabela ou alias.

    SELECT o.id, c.name
    FROM orders o
    JOIN customers c ON c.id = o.customer_id;
  2. No PL/pgSQL, dê aos parâmetros um prefixo, ou qualifique-os com o nome da função.

    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 diga ao PL/pgSQL para preferir a coluna: adicione #variable_conflict use_column no topo do corpo da função.

Reproduza com segurança

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

Erros relacionados

Mais erros de sintaxe ou violação de regra de acesso

O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com PostgreSQL no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o PostgreSQL e os outros bancos de dados que você usa.