// Referência de erro do PostgreSQL

PostgreSQL 42803: a coluna deve aparecer na cláusula GROUP BY

Uma consulta com GROUP BY ou um agregado seleciona uma coluna que não é agrupada nem agregada, então não há um valor único para mostrar por grupo.

SQLSTATE
42803
Nome
grouping_error
Categoria
Erro de sintaxe ou violação de regra de acesso
Mensagem de erro
column "o.customer_id" must appear in the GROUP BY clause or be used in an aggregate function

O que significa

Com GROUP BY (ou qualquer agregado como count(*)), cada linha de saída representa um grupo de linhas de entrada. Cada coluna selecionada precisa então ser uma das colunas de agrupamento, estar dentro de um agregado ou depender funcionalmente da chave primária agrupada. Caso contrário, o valor dela poderia variar dentro do grupo, e o PostgreSQL não escolhe um valor arbitrariamente, então ele gera 42803 (grouping_error).

O MySQL com ONLY_FULL_GROUP_BY desativado permite tais consultas, então isso aparece frequentemente ao mover consultas para o PostgreSQL. O mesmo código cobre agregações no lugar errado, como aggregate functions are not allowed in WHERE.

Causas comuns

  • Uma coluna selecionada que está ausente em GROUP BY.
  • Agrupando por uma expressão, mas selecionando a coluna subjacente.
  • Uma agregação usada em WHERE em vez de HAVING.
  • Consultas escritas para o modo permissivo de agrupamento do MySQL.

Como corrigir

  1. Adicione a coluna ao GROUP BY, ou agregue-a.

    SELECT o.customer_id, count(*) AS orders, max(o.created_at) AS last_order
    FROM orders o
    GROUP BY o.customer_id;
  2. Agrupe pela chave primária da tabela; suas outras colunas então são permitidas na lista de seleção.

    SELECT c.id, c.name, count(o.id)
    FROM customers c
    LEFT JOIN orders o ON o.customer_id = c.id
    GROUP BY c.id;
  3. Para manter uma linha inteira por grupo, use DISTINCT ON ou uma função de janela em vez de GROUP BY.

    SELECT DISTINCT ON (customer_id) *
    FROM orders
    ORDER BY customer_id, created_at DESC;
  4. Filtre agregados com HAVING.

    SELECT customer_id FROM orders GROUP BY customer_id HAVING count(*) > 5;

Reproduza com segurança

SELECT x, count(*) FROM (VALUES (1, 'a')) v(x, y) GROUP BY y;  -- ERROR: column "v.x" must appear in the GROUP BY clause ...

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.