// Referência de erro do PostgreSQL

PostgreSQL 42P10: referência de coluna inválida

Geralmente é um alvo de ON CONFLICT sem nenhum índice único correspondente, ou um ORDER BY com SELECT DISTINCT numa coluna que não está selecionada.

SQLSTATE
42P10
Nome
invalid_column_reference
Categoria
Erro de sintaxe ou violação de regra de acesso
Mensagem de erro
there is no unique or exclusion constraint matching the ON CONFLICT specification

O que significa

42P10 (invalid_column_reference) é gerado quando uma lista de colunas se refere a colunas de uma forma que a instrução não permite. Os dois casos mais comuns:

INSERT ... ON CONFLICT (cols) precisa de um índice único ou restrição exatamente nessas colunas (ou uma restrição de exclusão), para que o PostgreSQL saiba o que conta como um conflito. E com SELECT DISTINCT, cada ORDER BY expressão deve aparecer na lista de seleção: for SELECT DISTINCT, ORDER BY expressions must appear in select list.

Causas comuns

  • ON CONFLICT (email) em uma tabela sem índice único em email, ou com um índice único em lower(email) ou em um conjunto de colunas diferente.
  • Um índice único parcial, que ON CONFLICT só é usado quando a instrução repete sua WHERE predicado.
  • SELECT DISTINCT a FROM t ORDER BY b.

Como corrigir

  1. Crie o índice único que define um conflito, ou nomeie o alvo do conflito para corresponder ao existente.

    CREATE UNIQUE INDEX users_email_key ON users (email);
    INSERT INTO users (email, name) VALUES ('[email protected]', 'Ada')
    ON CONFLICT (email) DO UPDATE SET name = EXCLUDED.name;
  2. Para uma expressão ou índice parcial, repita a expressão ou o predicado no alvo do conflito.

    CREATE UNIQUE INDEX users_email_lower_key ON users (lower(email));
    INSERT INTO users (email) VALUES ('[email protected]')
    ON CONFLICT ((lower(email))) DO NOTHING;
  3. Com DISTINCT, escolha por o que você ordena, ou use DISTINCT ON.

    SELECT DISTINCT customer_id, created_at FROM orders ORDER BY created_at;
    -- or one row per customer, newest first:
    SELECT DISTINCT ON (customer_id) customer_id, created_at
    FROM orders ORDER BY customer_id, created_at DESC;

Reproduza com segurança

CREATE TEMP TABLE u (email text);
INSERT INTO u VALUES ('a') ON CONFLICT (email) DO NOTHING;  -- ERROR: there is no unique or exclusion constraint matching the ON CONFLICT specification

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.