blog
Revenda

Reparar o banco de um cliente pelo WHM sem a senha dele

Como localizar a conta pelo domínio, interpretar a saída do reparo tabela por tabela e reconhecer o momento em que insistir custa mais dados do que restaurar o backup.

JR · · 8 min de leitura · 1 tabela · 3 blocos de código

Resposta curta: use WHM » SQL Services » Repair a MySQL Database. São 4 passos: localizar a conta pelo domínio, confirmar o banco no wp-config.php, rodar o reparo e validar pelo site. Pare e restaure o backup se a saída indicar reparo anterior falho ou linhas descartadas.

Neste artigo
  1. Reparar o banco do cliente sem pedir a senha do cPanel
  2. O que conferir antes de clicar em reparar
  3. Rodando o reparo pelo WHM
  4. O que cada mensagem da saída quer dizer
  5. Três situações em que o reparo não resolve nada
  6. Quando restaurar o backup custa menos que insistir no reparo
  7. Duas mensagens prontas para avisar o cliente
  8. Três hábitos que reduzem a frequência de corrupção

Reparar o banco do cliente sem pedir a senha do cPanel

O cliente liga dizendo que o site saiu do ar. No navegador aparece "Error establishing a database connection" ou uma página branca com erro de tabela corrompida. Você é o revendedor, tem WHM, mas não tem (e nem deveria pedir) a senha do cPanel daquela conta.

O WHM resolve isso. A interface SQL Services » Repair a MySQL Database lista os bancos do servidor e executa o reparo sem que você precise logar na conta do cliente nem abrir o phpMyAdmin dele. Segundo a documentação oficial do cPanel, a interface permite selecionar um banco de dados e executar o reparo em suas tabelas, exibindo o resultado por tabela.

O que a documentação não resolve por você é o critério de parada. Reparo é operação destrutiva em potencial: ele reconstrói índices e, em tabela muito danificada, pode descartar linhas que não consegue ler. Há um ponto em que insistir no reparo custa mais dados do que restaurar o backup de ontem. Esse ponto está na seção final.

O que conferir antes de clicar em reparar

Checklist que vale para qualquer site de cliente, não só o que está quebrado agora:

  1. Backup antes do reparo. Se existe backup automático do servidor, confirme a data do último snapshot do banco. Se não existe, tire um dump antes: o reparo não tem desfazer.
  2. Espaço em disco. Reparo de tabela cria arquivos temporários. Partição cheia é causa comum de corrupção e vai causar de novo durante o reparo.
  3. Identificar a conta pelo domínio. Você precisa do usuário cPanel para saber qual prefixo de banco procurar.
  4. Saber o engine das tabelas. MyISAM e InnoDB se comportam de forma completamente diferente aqui, e isso muda a decisão inteira.
  5. Avisar que o site pode ficar indisponível durante o procedimento. Reparo tranca a tabela.

Como achar a conta e o banco certo partindo do domínio

No WHM, use Account Information » List Accounts e filtre pelo domínio. Você obtém o usuário cPanel. Os bancos daquela conta usam esse usuário como prefixo, no padrão usuario_nomedobanco.

Se preferir terminal:

# descobre o usuário cPanel dono do domínio
/scripts/whoowns exemplo.com.br

# lista os bancos cujo prefixo é daquele usuário
mysql -e "SHOW DATABASES LIKE 'usuario\_%';"

Para confirmar qual banco o WordPress realmente usa (o cliente pode ter três bancos antigos no servidor), leia o wp-config.php da conta:

grep -E "DB_NAME|DB_USER|DB_HOST" /home/usuario/public_html/wp-config.php

Esse grep é o passo que mais economiza tempo. Reparar o banco errado é um erro frequente de quem faz isso com pressa.

Ordem de trabalho do reparo pelo WHMIdentificar a contawhoowns pelo domínioConfirmar o bancogrep no wp-config.phpBackup e discodump antes, checar espaçoRodar o reparoWHM, SQL ServicesValidar no siteabrir wp-admin e logar
Sequência mínima antes e depois do reparo pelo WHM.

Rodando o reparo pelo WHM

Onde fica a interface Repair a MySQL Database

WHM » SQL Services » Repair a MySQL Database. A documentação do cPanel descreve a interface como o local para reparar um banco de dados MySQL do servidor.

Como não reparar o banco errado na hora de selecionar

Escolha na lista o banco identificado no wp-config.php. Confira o prefixo: clienteabc_wp01 e clienteabc_wp01_old ficam lado a lado na lista e são um clique de distância um do outro.

O que acompanhar enquanto o reparo roda

O reparo roda tabela por tabela e imprime o status de cada uma. Não feche a aba: se a sessão cair no meio, você fica sem o relatório e sem saber onde parou.

Por que tela verde não significa site no ar

Tela verde não é site no ar. Abra o site, abra o /wp-admin, faça um login. Só então avise o cliente.

O que cada mensagem da saída quer dizer

A saída é um relatório com uma linha por tabela. Interpretação:

Mensagem O que significa O que fazer
OK A tabela foi verificada e está consistente, ou foi reparada com sucesso Nada
Table is already up to date Nada a fazer: a tabela não precisava de reparo Nada
Table is marked as crashed and should be repaired Tabela MyISAM continua marcada como corrompida depois da passada: o reparo não concluiu Repetir o reparo uma vez; se a mensagem persistir, tratar a tabela como candidata a restauração de backup
Table is marked as crashed and last (automatic?) repair failed Já houve tentativa de reparo que falhou Sinal forte de parada: avalie restaurar backup
The storage engine for the table doesn't support repair Engine (tipicamente InnoDB) não aceita REPAIR TABLE Caminho diferente, ver seção seguinte
Number of rows changed from X to Y O reparo descartou linhas ilegíveis Houve perda de dados: precisa comunicar o cliente

A linha mais importante da tabela acima é a última. Number of rows changed não é aviso cosmético: é o reparo dizendo quantos registros ele jogou fora para conseguir reconstruir o índice. Se isso aparecer em wp_posts, wp_users ou numa tabela de pedidos de loja, pare e compare com o backup antes de dar o serviço por encerrado.

Três situações em que o reparo não resolve nada

Por que InnoDB não é reparado por essa interface

REPAIR TABLE atua em engines como MyISAM, ARCHIVE e CSV. InnoDB não é reparado por esse comando, e o WordPress moderno cria tabelas InnoDB por padrão. Resultado prático: você roda o reparo, recebe a mensagem de engine não suportado e o site continua quebrado.

Para confirmar o engine de cada tabela:

SELECT table_name, engine FROM information_schema.tables
WHERE table_schema = 'usuario_banco';

Corrupção de InnoDB é problema de nível de servidor, não de interface de reparo: envolve log de erro do MySQL, eventualmente modo de recuperação forçada e, quase sempre, restauração de backup. Se você é revendedor e não administra o daemon MySQL, é aqui que você abre chamado no provedor em vez de tentar sozinho.

O banco do cliente não aparece na lista

Se o banco do cliente não está na lista, as hipóteses em ordem de probabilidade: o banco pertence a outro usuário cPanel (site migrado, conta duplicada), o nome real difere do que você supôs (confira o wp-config.php), ou o site usa um host remoto em DB_HOST e o banco nem está nesse servidor. Essa terceira hipótese explica muito "reparei e não mudou nada".

O reparo rodou e o site continua em erro de conexão

"Error establishing a database connection" raramente é tabela corrompida. Na maioria dos casos é credencial inválida no wp-config.php, usuário sem privilégio no banco, ou o serviço MySQL fora do ar. Verifique o serviço primeiro: se o MySQL caiu, nenhum site da revenda abre, e o diagnóstico muda de "site do cliente" para "servidor".

Quando restaurar o backup custa menos que insistir no reparo

Esta é a parte que ninguém escreve. Pare o reparo e restaure o backup quando qualquer uma destas condições for verdadeira:

Regra prática: reparo é para tabela danificada de forma isolada; backup é para banco danificado. Se mais de uma tabela do core aparece quebrada na mesma passada, não é tabela, é o banco, e você está remendando um arquivo que o disco já corrompeu.

Reparar ou restaurar: critério de decisãoEngine é InnoDB?Sim: não repare, chamado ou backupMensagem de repair failed?Sim: restaure o backupRows changed em tabela de conteúdo?Compare com o backup antes de encerrarTerceira rodada na mesma tabela?Pare, restaure e investigue a causaMais de uma tabela do core quebrada?É o banco, não a tabelaNenhuma acimaReparo isolado resolve, valide o site
Critério de parada: quando restaurar sai mais barato que insistir.

Duas mensagens prontas para avisar o cliente

Duas frases prontas, para copiar e adaptar.

Quando o reparo foi limpo:

Quando houve perda:

O ponto da segunda frase é oferecer a escolha ao cliente com a data explícita. Quem decide o que é mais caro, perder o conteúdo de hoje ou perder registros antigos, é ele.

Três hábitos que reduzem a frequência de corrupção

O reparo é consequência. Três hábitos reduzem a frequência com que você precisa abrir essa tela:

E registre em algum lugar, por cliente, a data do último incidente de banco. Três corrupções em seis meses no mesmo site não é azar: é disco, é plugin escrevendo em laço ou é memória insuficiente derrubando o MySQL. O reparo trata o sintoma; a terceira ocorrência é o pedido de investigação da causa.

Referências

  1. Documentação oficial (cpanel) — WHM Repair a MySQL Database. Consultado em 2026-10-14.
Leia também