PostgreSQL • Manutenção

Rotinas de manutenção mantêm suas tabelas e índices saudáveis e rápidas. Nesta tela você encontra ações guiadas para Verificar (checagens gerais), Analyze (atualizar estatísticas), Vacuum (limpar e liberar espaço interno), Reindex (reconstruir índices) e, quando aplicável, Cluster (reordenar dados pelo índice). Use após grandes mudanças, quedas de performance, ou em janelas programadas.

Abrir “Manutenção”

1. Conecte-se à sua conexão PostgreSQL e selecione o banco.
2. Escolha o schema e a tabela alvo.
3. No menu da tabela, toque em Manutenção.

O que você pode fazer aqui

• Verificar — checagens básicas de metadados e estado.
• Analyze — atualiza estatísticas do otimizador (melhora planos de execução).
• Vacuum — remove tuplas mortas e reduz bloat lógico; opção de Vacuum Full quando indicado.
• Reindex — reconstrói índice(s) para recuperar eficiência.
• Cluster (quando disponível) — reordena fisicamente a tabela conforme um índice escolhido.

Dica: Em geral, Analyze é rápido e pode ser feito com frequência. Vacuum/Reindex/Cluster exigem mais tempo e devem ser planejados em janelas.

Analyze (estatísticas)

Atualiza estatísticas de cardinalidade e distribuição. Recomendado após:

• Grandes inserções/exclusões ou cargas de dados.
• Criação/remoção de índices.
• Mudanças estruturais (tipos, colunas-chave).

Na tela, toque em Analyze e acompanhe o status.

Vacuum (bloat e limpeza)

• Vacuum padrão remove tuplas mortas e ajuda o autovacuum a manter a tabela saudável.
• Vacuum Full recompõe a tabela liberando espaço ao SO, porém bloqueia a tabela; use apenas quando necessário.
• Para bases ativas, programe Vacuum em horários de menor uso.

Observação: O autovacuum do PostgreSQL costuma dar conta do dia a dia. Use esta tela para casos especiais ou quando identificar bloat elevado.

Reindex (índices ineficientes)

• Reconstrói índice(s) que cresceram demais ou perderam eficiência após muitas alterações.
• Útil se consultas indexadas ficaram mais lentas sem mudança na lógica.
• Planeje janela; reconstruções podem impactar escrita/leitura.

Cluster (reordenar por índice)

• Reordena fisicamente a tabela seguindo um índice selecionado.
• Ajuda leituras sequenciais em consultas que filtram/ordenam pela mesma chave com frequência.
• Exige janela de manutenção; a operação é mais pesada que Analyze/Vacuum.

Quando usar cada ação

• Analyze: sempre após grandes mudanças de dados/índices; rápido e seguro.
• Vacuum: quando notar crescimento de bloat/tuplas mortas ou pressão no autovacuum.
• Reindex: se índices perderam eficiência (tamanho/estatísticas indicam degradação).
• Cluster: para ganhos de leitura sequencial em tabelas críticas com padrão de acesso estável.

Boas práticas

• Defina uma janela recorrente para Analyze e, quando necessário, para Vacuum/Reindex.
• Monitore tempo, locks e impacto em consultas críticas.
• Em tabelas particionadas, priorize partições ativas; ações podem ser aplicadas por partição.
• Valide desempenho após manutenção (consultas-chave, planos, latência média).

Erros comuns (e soluções)

“Tempo excedido / bloqueios prolongados”

• Agende fora do pico e fatie por partições/tabelas menores primeiro.

“Espaço insuficiente durante Vacuum Full/Cluster”

• Garanta espaço em disco adicional para a operação, ou opte por rotinas menos intrusivas.

“Permissão negada”

• Use conta com privilégios adequados no schema/tabela e para manutenção.

“Autovacuum atrapalhando janelas”

• Coordene com a equipe de DBAs para ajustar autovacuum (limiares/custos) no servidor, quando apropriado.

Ferramentas relacionadas

• Partições: PostgreSQL • Partições.
• Índices: PostgreSQL • Índices.
• Executar consultas: PostgreSQL • Executar SELECT.
• Editar dados: PostgreSQL • CRUD.

Próximo: PostgreSQL • CRUD • Voltar: PostgreSQL • Partições