receita

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.

resposta curtaLimpar o banco do WordPress é seguro quando segue uma ordem: backup completo, remoção do que o núcleo recria sozinho (transients expirados, lixeira, revisões antigas), checagem de opções autoload pesadas e, por fim, otimização das tabelas. Faça tudo em WP-CLI, em homologação primeiro, e nunca apague dados de plugin sem entender de quem são.
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

  1. 01Faça backup completo do banco e dos arquivos e teste a restauração.
  2. 02Meça o ponto de partida: tamanho das tabelas e opções autoload.
  3. 03Remova transients vencidos, lixeira e revisões antigas.
  4. 04Trate metadados órfãos com consulta de conferência antes do DELETE.
  5. 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.

  1. Compare os tamanhos antes e depois (wp db size).
  2. Navegue por home, post, categoria, busca, formulário, login e compra, se houver.
  3. Abra o painel e uma tela de edição; crie um rascunho de teste.
  4. Confira o log de erros do PHP por avisos nas horas seguintes.
  5. Se algo falhar, restaure: wp db import backup-antes-da-limpeza-AAAA-MM-DD.sql.

Erros comuns e como desfazer

ErroEfeitoCorreção
Limpar sem backupperda irreversívelpare e exija backup
Apagar tabelas de plugins "desconhecidos"perda de dados de negócioinvestigue antes
Rodar DELETE sem COUNT préviosurpresa no volumesempre conte antes
Otimizar em horário de picolentidãoagende para madrugada
Limite de revisões baixo demaishistórico curtouse 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

  1. wp transient delete, WP-CLI Handbook (2026-10-14)
  2. wp db optimize, WP-CLI Handbook (2026-10-14)
  3. Editing wp-config.php, WordPress Advanced Administration Handbook (2026-10-14)
  4. wp_autoload_values_to_autoload(), WordPress Developer Resources (2026-10-14)
  5. 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.