// Referência de erro do PostgreSQL

PostgreSQL 42703: coluna não existe

Um nome de coluna na consulta não existe nas tabelas que ela enxerga. Geralmente é um erro de digitação, um nome com maiúsculas e minúsculas misturadas, ou aspas duplas usadas para um valor de string.

SQLSTATE
42703
Nome
undefined_column
Categoria
Erro de sintaxe ou violação de regra de acesso
Mensagem de erro
column "emial" does not exist
LINE 1: SELECT emial FROM users;
               ^
HINT:  Perhaps you meant to reference the column "users.email".

O que significa

O PostgreSQL não conseguiu corresponder uma referência de coluna a qualquer coluna das tabelas na FROM cláusula. Quando existe um nome parecido, as versões recentes adicionam um HINT sugerindo isso.

Duas regras do PostgreSQL causam a maioria desses erros. Identificadores sem aspas ficam em minúsculas, então uma coluna criada como "createdAt" deve ser escrita com aspas. E aspas duplas sempre significam um identificador, nunca uma string, então WHERE status = "active" procura por uma coluna chamada active.

Causas comuns

  • Um erro de digitação, ou uma coluna que foi renomeada ou ainda não adicionada.
  • Uma coluna criada com letras maiúsculas e minúsculas misturadas entre aspas ("userId") referenciada sem aspas.
  • Um valor de string escrito entre aspas duplas: WHERE name = "Ada" em vez de 'Ada'.
  • Referenciando um alias da lista de seleção em WHERE ou GROUP BY expressões onde ele não é visível: aliases só podem ser usados em ORDER BY (e como um nome simples em GROUP BY).
  • Usando a coluna de um alias de tabela que não é a tabela correta, ou uma coluna de uma subconsulta que não foi selecionada nela.

Como corrigir

  1. Liste os nomes reais das colunas da tabela.

    SELECT column_name, data_type
    FROM information_schema.columns
    WHERE table_schema = 'public' AND table_name = 'users'
    ORDER BY ordinal_position;
  2. Use aspas simples para valores e aspas duplas apenas para identificadores.

    SELECT * FROM users WHERE status = 'active';
  3. Coloque entre aspas os nomes de colunas com letras maiúsculas e minúsculas exatamente como foram criados.

    SELECT "userId", "createdAt" FROM events;
  4. Repita a expressão, ou envolva a consulta, em vez de usar um alias em WHERE.

    SELECT * FROM (
        SELECT id, price * qty AS total FROM order_lines
    ) t
    WHERE total > 100;

Reproduza com segurança

CREATE TEMP TABLE users (id int, email text);
SELECT emial FROM users;  -- ERROR: column "emial" does not exist

Perguntas

Por que WHERE name = "Ada" diz que a coluna Ada não existe?

No PostgreSQL, aspas duplas marcam um identificador, como o nome de uma coluna ou tabela. Valores de string usam aspas simples: WHERE name = 'Ada'.

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.