Relações que a análise de uma coluna não mostra
As estatísticas estendidas são informações que o PostgreSQL coleta sobre colunas ou expressões para estimar o resultado de consultas. No uso com várias colunas, elas descrevem relações que as estatísticas individuais deixam de representar. O planejador usa essas estimativas ao escolher como executar a consulta.
Uma cidade pode aparecer associada a vários códigos postais, mas um código postal pode determinar a cidade. Quando a consulta filtra os dois campos, considerar os filtros independentes pode levar o planejador a estimar menos linhas do que existem. As estatísticas de dependência funcional permitem considerar essa relação no cálculo.
O papel de CREATE STATISTICS e ANALYZE
Você escolhe as colunas e o tipo de estatística com CREATE STATISTICS. O comando registra o objeto no catálogo, mas a coleta ocorre durante o ANALYZE. No exemplo didático abaixo, a tabela enderecos já deve existir com as colunas cidade e cep.
CREATE STATISTICS cidade_cep (dependencies)ON cidade, cep FROM enderecos;ANALYZE enderecos;A opção dependencies solicita a análise de dependências entre as duas colunas. O resultado dessa coleta é uma descrição estatística disponível para o planejador, sem criar um índice. Para conferir seu efeito, compare a estimativa de linhas do plano com as linhas observadas na execução de uma consulta que filtre cidade e CEP por igualdade.
A coleta usa uma amostra da tabela, por isso a estimativa pode continuar diferente do resultado observado. Outros tipos de estatísticas descrevem combinações frequentes ou o número de combinações distintas e atendem a consultas com necessidades diferentes. Criar um objeto para cada combinação de colunas aumenta o trabalho de análise sem assegurar um plano melhor.
Dúvidas frequentes
Perguntas frequentes sobre estatísticas estendidas
- Quando o planejador pode usar as estatísticas coletadas?
- O CREATE STATISTICS registra o objeto a coletar. Os valores são calculados pelo ANALYZE, executado manualmente ou pela análise automática da tabela.
- Um índice composto tem a mesma função?
- O índice oferece uma estrutura de acesso aos registros. As estatísticas descrevem sua distribuição para o planejador estimar o resultado. Uma consulta pode precisar dos dois recursos.
- As dependências funcionais ajudam em qualquer filtro?
- O PostgreSQL aplica esse tipo a comparações de igualdade com constantes e a condições IN com constantes. Ele não usa essas dependências para melhorar estimativas de intervalos ou de filtros LIKE.
Para continuar
Recursos relacionados
Documentação
PostgreSQL: estimativas com relações entre colunas
Explica a coleta por amostragem e os tipos de estatísticas usados para estimar relações entre colunas.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
Acompanhamento ao vivo para investigar consultas e comparar seus planos de execução no banco da aplicação.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
Você pode comparar a estimativa de linhas do plano com o resultado da consulta ao revisar alterações no banco feitas 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.