Cálculo sobre um conjunto de linhas
Um agregado é uma função que calcula um resultado a partir de um conjunto de valores de várias linhas. O SUM soma os valores recebidos e o AVG calcula sua média. A cláusula GROUP BY separa as linhas em grupos para que cada um tenha seu próprio cálculo.
Soma das vendas por cidade
Neste exemplo didático, a tabela vendas tem as colunas cidade, valor e status. A consulta usa apenas vendas pagas e apresenta o total de cada cidade que ultrapassou 1000.
SELECT cidade, SUM(valor) AS totalFROM vendasWHERE status = 'pago'GROUP BY cidadeHAVING SUM(valor) > 1000;Duas vendas pagas de 700 e 500 na mesma cidade produzem total 1200. Uma venda pendente dessa cidade fica fora do cálculo por causa do WHERE. O HAVING examina o total já calculado, por isso uma cidade com soma 800 não aparece.
Entradas nulas e linhas repetidas
O SUM ignora valores nulos. Quando não há entradas para somar, retorna NULL, portanto você precisa distinguir a ausência de valor de um total igual a zero no relatório. O COUNT(*) mede o número de linhas e o COUNT(valor) inclui apenas as linhas com valor não nulo.
Uma junção pode repetir a mesma venda em várias linhas antes da agregação. Para conferir um total inesperado, examine as linhas que a junção produz: o SUM calcula sobre essa entrada e não reconhece automaticamente que duas linhas se referem à mesma venda.
Dúvidas frequentes
Perguntas frequentes sobre agregado
- Uma agregação sempre retorna uma única linha?
- Uma consulta com GROUP BY pode produzir uma linha por grupo. Uma consulta só com agregados e sem GROUP BY calcula um único grupo, mesmo quando nenhuma linha atende ao filtro.
- Qual é a diferença entre WHERE e HAVING?
- O WHERE seleciona as linhas que entram no cálculo. O HAVING seleciona os grupos após a agregação, por exemplo para mostrar apenas cidades cuja soma das vendas ultrapassa um valor.
- Como COUNT e SUM tratam valores nulos?
- O COUNT(*) inclui todas as linhas. O COUNT(coluna) inclui apenas aquelas nas quais a coluna não é nula. O SUM ignora entradas nulas e retorna NULL quando não há valores para somar.
Para continuar
Recursos relacionados
Documentação
PostgreSQL: agregação com GROUP BY e HAVING
Exemplos de agrupamento e filtragem das linhas e dos grupos calculados.
Abrir recursoDocumentação
PostgreSQL: funções de agregado e valores nulos
Comportamento de COUNT e SUM, inclusive quando não há entradas para o cálculo.
Abrir recursoSite de referência
Dev Side Studio: Desenvolvimento Colaborativo
Você pode usar o Desenvolvimento Colaborativo para investigar uma soma incorreta e revisar os agrupamentos da consulta com orientação ao vivo.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Você precisa conferir agrupamentos e filtros para interpretar os totais apresentados por consultas e relatórios gerados com agentes.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.