Receita: limpar e otimizar o banco
Revisões, transients, comentários descartados e metadados órfãos, com backup antes e WP-CLI no lugar de cliques.
Neste texto
Que problema esta receita resolve?
Bancos de sites antigos acumulam centenas de revisões por post, milhares de transients vencidos, comentários de spam e metadados de conteúdos que já não existem. Isso aumenta o tamanho dos backups, deixa consultas mais lentas e, quando existem opções gigantes marcadas para carregar em toda requisição, atrasa o tempo de resposta do servidor (TTFB). A receita lista o que pode ser limpo com segurança e o que exige cuidado.
A lógica vem de um plugin de otimização e limpeza de banco que Camillo Dantas desenvolveu; ele não é vendido. Aqui está o método, em comandos que você controla.
Quando usar e quando não usar
Use quando o banco cresceu sem explicação, o backup demora, o painel está lento ou a hospedagem cobra por espaço.
Não use:
- sem backup restaurável e testado;
- em produção sem ter rodado o mesmo roteiro em cópia;
- para "limpar tudo" de plugins que você não reconhece. Tabelas e opções de plugin podem parecer lixo e ser dados de clientes, pedidos ou licenças;
- como promessa de ganho de nota. O efeito é redução de tamanho e, às vezes, de tempo de resposta do servidor.
Pré-requisitos
- Acesso SSH e WP-CLI.
- Espaço para o arquivo de backup.
- Janela de baixo tráfego.
- Nível: avançado.
Passo a passo
- 01Faça backup completo do banco e dos arquivos e teste a restauração.
- 02Meça o ponto de partida: tamanho das tabelas e opções autoload.
- 03Remova transients vencidos, lixeira e revisões antigas.
- 04Trate metadados órfãos com consulta de conferência antes do DELETE.
- 05Otimize as tabelas e meça de novo.
Passo 1: backup
wp db export backup-antes-da-limpeza-$(date +%F).sql
ls -lh backup-antes-da-limpeza-*.sql
Guarde o arquivo fora da pasta pública. Para testar a restauração, importe-o em um banco de teste com wp db import num ambiente separado.
Passo 2: ponto de partida
wp db size --tables --size_format=mb
wp db query "SELECT COUNT(*) FROM wp_posts WHERE post_type='revision'"
wp db query "SELECT COUNT(*) FROM wp_options WHERE option_name LIKE '\_transient\_%'"
Troque wp_ pelo prefixo do seu banco (wp db prefix mostra). Anote os números.
Para opções que carregam em toda requisição, liste as maiores. Desde o WordPress 6.6, os valores do campo autoload deixaram de ser apenas yes e no; confira o que existe no seu banco antes de filtrar:
wp db query "SELECT DISTINCT autoload FROM wp_options"
wp db query "SELECT option_name, LENGTH(option_value) AS bytes FROM wp_options WHERE autoload IN ('yes','on','auto','auto-on') ORDER BY bytes DESC LIMIT 20"
Opções com centenas de kilobytes que carregam sempre são candidatas à investigação. Identifique a qual plugin pertencem pelo prefixo do nome e consulte o desenvolvedor antes de mexer. Não delete às cegas.
Passo 3: o que o núcleo recria sozinho
Transients vencidos: comando oficial do WP-CLI, que aceita --expired.
wp transient delete --expired
Lixeira e comentários descartados:
wp post delete $(wp post list --post_status=trash --format=ids) --force
wp comment delete $(wp comment list --status=spam --format=ids) --force
wp comment delete $(wp comment list --status=trash --format=ids) --force
Se a lista estiver vazia, o WP-CLI reclama de argumento ausente; isso é inofensivo.
Revisões: antes de apagar, defina uma política para o futuro. A constante WP_POST_REVISIONS em wp-config.php aceita false (desliga) ou um inteiro que limita o número por post. Um limite como 5 mantém histórico útil sem inchar:
define( 'WP_POST_REVISIONS', 5 );
Depois remova as revisões existentes. Esta ação apaga o histórico de edições; só execute depois do backup:
wp post delete $(wp post list --post_type=revision --format=ids) --force
Em bancos grandes, rode por lotes (--posts_per_page=500) para não estourar a memória.
Passo 4: metadados órfãos
Primeiro conte; depois apague. A consulta de conferência:
wp db query "SELECT COUNT(*) FROM wp_postmeta pm LEFT JOIN wp_posts p ON p.ID = pm.post_id WHERE p.ID IS NULL"
Se o número for plausível, remova:
wp db query "DELETE pm FROM wp_postmeta pm LEFT JOIN wp_posts p ON p.ID = pm.post_id WHERE p.ID IS NULL"
O mesmo raciocínio vale para wp_commentmeta (ligada a wp_comments) e para relações de termos. Metadados ligados a tipos de conteúdo de plugins que você desativou temporariamente também ficam "órfãos" em aparência; por isso o backup e o teste em cópia.
Passo 5: otimizar as tabelas
O comando wp db optimize executa o mysqlcheck com a opção de otimização, usando as credenciais do wp-config.php:
wp db optimize
Em tabelas InnoDB, o servidor refaz a tabela e recupera espaço; durante a operação pode haver bloqueios. Rode em horário calmo. Meça o tamanho de novo com o comando do passo 2.
Como testar
Critério de sucesso: o banco ficou menor, o site funciona igual em todas as páginas-modelo, o administrador abre sem erro e o backup antigo restaura em um ambiente de teste.
- Compare os tamanhos antes e depois (
wp db size). - Navegue por home, post, categoria, busca, formulário, login e compra, se houver.
- Abra o painel e uma tela de edição; crie um rascunho de teste.
- Confira o log de erros do PHP por avisos nas horas seguintes.
- Se algo falhar, restaure:
wp db import backup-antes-da-limpeza-AAAA-MM-DD.sql.
Erros comuns e como desfazer
| Erro | Efeito | Correção |
|---|---|---|
| Limpar sem backup | perda irreversível | pare e exija backup |
| Apagar tabelas de plugins "desconhecidos" | perda de dados de negócio | investigue antes |
| Rodar DELETE sem COUNT prévio | surpresa no volume | sempre conte antes |
| Otimizar em horário de pico | lentidão | agende para madrugada |
| Limite de revisões baixo demais | histórico curto | use um valor como 5 a 10 |
A única reversão real é a restauração do backup. Por isso o primeiro passo não é opcional.
Checklist final
- Backup restaurável e testado.
- Números de partida anotados.
- Transients vencidos removidos.
- Política de revisões definida.
- Órfãos contados antes do DELETE.
- Opções autoload grandes investigadas.
- Tabelas otimizadas e site testado.
Em conjunto com outras rotinas
A manutenção do banco combina com cache e PWA e com a auditoria de conteúdo, que ajuda a decidir o que arquivar antes de limpar. O curso Core Web Vitals trata o papel do servidor na velocidade. No glossário, veja TTFB. Plugins de origem: camillodantas.com.br/plugins.
Fontes
- wp transient delete, WP-CLI Handbook (2026-10-14)
- wp db optimize, WP-CLI Handbook (2026-10-14)
- Editing wp-config.php, WordPress Advanced Administration Handbook (2026-10-14)
- wp_autoload_values_to_autoload(), WordPress Developer Resources (2026-10-14)
- wp db export, WP-CLI Handbook (2026-10-14)
Não sabe por onde começar?
Compare as opções e escolha a trilha pelo seu objetivo.