SQL AVG()

Quanto custa, em média, um produto da Loja Aurora? Quantos dias uma entrega leva? Qual é o salário médio da equipe? A média é a conta da escola: some tudo e divida pela quantidade. Em SQL, ela se chama AVG(), do inglês average, "média". A conta é simples, mas o resultado costuma sair com uma fila de casas decimais, e a média tem pegadinhas com o zero, com o NULL e com a divisão de números inteiros. Esta aula mostra todas, com os números reais da loja.

A ideia: a média do boletim

No boletim, a média de quatro provas com notas 7, 8, 6 e 9 é (7 + 8 + 6 + 9) ÷ 4 = 7,5. São dois passos: somar e dividir pela quantidade. O AVG() faz os dois de uma vez, com todas as linhas da coluna. E, assim como o professor não conta uma prova que o aluno não fez, o AVG() não conta os NULL: eles saem da soma e da quantidade.

1. A primeira média

SELECT AVG(preco) AS preco_medio
FROM produtos;

AVG

A função de média.

(preco)

A coluna cuja média você quer. Como no SUM, vai uma coluna (ou uma conta), nunca *.

AS preco_medio

O apelido da coluna do resultado.

O preço médio é 48.2053333333333. Essa fila de 3 é uma dízima: a soma dos preços (2169.24) dividida por 45 não dá um número "redondo". O SQLite mostra até 15 algarismos e para ali; a conta de verdade continuaria para sempre.

Arredondar com ROUND

Ninguém escreve um preço com 13 casas. Embrulhe a média em ROUND(…, 2) para ficar com 2 casas, os centavos:

SELECT ROUND(AVG(preco), 2) AS preco_medio
FROM produtos;

ROUND( … , 2)

"Arredondar", com 2 casas decimais. Primeiro o AVG calcula 48.2053333333333; depois o ROUND arredonda para 48.21. Com 1 casa, daria 48.2; sem o segundo número, ROUND(AVG(preco)) dá 48.0.

Com WHERE, a média é só das linhas que passaram. O salário médio de quem trabalha nas vendas:

SELECT AVG(salario) AS media_vendas
FROM funcionarios
WHERE cargo LIKE 'Vendedor%';

Aqui a média saiu "redonda", 3131.51, porque a conta fechou em duas casas. Repare que o SQLite não escreve zeros sobrando: se fosse 3131.50, ele escreveria 3131.5.

SELECT AVG(frete) AS frete_medio
FROM pedidos;

SELECT ROUND(AVG(frete), 2) AS frete_medio
FROM pedidos;

2. AVG é SUM dividido por COUNT

Você pode conferir a conta do AVG fazendo os dois passos à mão:

SELECT SUM(preco)                AS soma,
       COUNT(preco)              AS quantos,
       SUM(preco) / COUNT(preco) AS na_mao,
       AVG(preco)                AS com_avg
FROM produtos;

Deu igual. Agora faça a mesma coisa com o estoque, que é uma coluna de inteiros:

SELECT AVG(estoque)                 AS com_avg,
       SUM(estoque) / COUNT(*)       AS na_mao,
       SUM(estoque) * 1.0 / COUNT(*) AS na_mao_com_1_0
FROM produtos;

O na_mao deu 73, e não 73.36! Quando os dois lados de uma divisão são inteiros (3301 e 45), o SQLite faz divisão inteira: joga fora tudo depois da vírgula, como a divisão "com resto" da escola. Multiplicar por 1.0 transforma a soma num número com decimais, e aí a divisão sai completa. O AVG não tem esse problema: ele sempre devolve um número com decimais (REAL), mesmo quando todos os valores são inteiros.

3. Zero entra na média; NULL não

Onze pedidos tiveram frete grátis: o frete deles é 0, um valor conhecido. Ele entra na média e a puxa para baixo:

SELECT AVG(frete) AS todos_os_pedidos
FROM pedidos;

SELECT AVG(frete) AS so_fretes_pagos, COUNT(*) AS pedidos
FROM pedidos
WHERE frete > 0;

Com os zeros, a média dos 90 pedidos é 14.49; só dos 79 fretes pagos, 16.51. As duas estão certas: respondem perguntas diferentes ("quanto o cliente paga de frete, em média?" e "quanto custa um frete, quando é cobrado?").

Já o NULL fica de fora sozinho. Quantos dias, em média, uma entrega leva? Os 5 pedidos que ainda não chegaram têm entregue_em NULL:

SELECT COUNT(*)           AS pedidos,
       COUNT(entregue_em) AS entregues,
       AVG(julianday(entregue_em) - julianday(data)) AS dias
FROM pedidos;

julianday(…)

Transforma uma data num número de dias, para dar para fazer conta. julianday('2024-01-10') - julianday('2024-01-05') dá 5.0. Ela tem aula própria: Funções de Data.

julianday(entregue_em) - julianday(data)

Quantos dias cada pedido levou. Nos 5 pedidos pendentes, entregue_em é NULL, e qualquer conta com NULL dá NULL.

AVG( … )

A média só dos 85 pedidos entregues: 6.0 dias. Os NULL saíram da soma e da contagem, sem você pedir.

Se o AVG contasse os pedidos pendentes como zero dias, a média cairia e a loja pareceria mais rápida do que é. Por isso a regra existe: desconhecido não é zero.

4. Média simples × média ponderada

"Qual é o preço médio dos itens vendidos?" parece uma pergunta só, mas tem duas respostas:

SELECT AVG(preco_unitario) AS media_simples,
       SUM(quantidade * preco_unitario) / SUM(quantidade) AS media_por_unidade
FROM itens_pedido;

A segunda é uma média ponderada (cada valor tem um "peso", aqui a quantidade). Ela saiu mais baixa porque os itens comprados em 2 ou 3 unidades são, em geral, de produtos mais baratos, que agora pesam mais na conta. Não existe uma "certa": escolha pela pergunta.

Mais um truque: média de uma coluna 0/1

Na coluna vip, que só tem 0 e 1, a média é a proporção de VIPs:

SELECT AVG(vip)                  AS proporcao,
       ROUND(AVG(vip) * 100, 1)  AS porcentagem
FROM clientes;

5 VIPs em 30 clientes: 0.166666666666667, ou 16.7%.

Quando dá errado

SELECT AVG(nascimento) FROM clientes;

SELECT AVG(nome) FROM clientes;

SELECT nome, preco
FROM produtos
WHERE preco > AVG(preco);

SELECT AVG(preco, estoque) FROM produtos;

SELECT AVG(estoque * 1.0) AS media FROM produtos;

Referência rápida

Exercícios

Missão final: o preço médio dos eletrônicos

SELECT AVG(preco) AS preco_medio
FROM produtos;

SELECT ROUND(AVG(preco), 2) AS preco_medio
FROM produtos
WHERE categoria_id = 2;

Resumo

• AVG(coluna) soma os valores e divide pela quantidade, ignorando os NULL nas duas contas.
• O resultado sai em REAL, muitas vezes com dízima (48.2053333333333). Arredonde com ROUND(AVG(x), 2).
• Divisão de dois inteiros no SQLite é inteira: 3301 / 45 = 73. Use * 1.0.
• Zero entra na média e a puxa para baixo; NULL não entra. Escolha o filtro pela pergunta.
• Média simples (AVG) e ponderada (SUM(peso * valor) / SUM(peso)) respondem perguntas diferentes.
• AVG de texto não dá erro: vale o número do começo do texto, ou 0. Não confie nesse resultado.