# 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.

> 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.

João Rizzon · 2026-11-08 · Revenda

---

## 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](https://docs.cpanel.net/whm/sql-services/repair-a-mysql-database/), 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:

- **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.
- **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.
- **Identificar a conta pelo domínio.** Você precisa do usuário cPanel para saber qual prefixo de banco procurar.
- **Saber o engine das tabelas.** MyISAM e InnoDB se comportam de forma completamente diferente aqui, e isso muda a decisão inteira.
- **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:

```bash
# 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:

```bash
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.

## 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:

```sql
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:

- A saída trouxe `last (automatic?) repair failed`. Já tentou e falhou uma vez.
- A saída trouxe `Number of rows changed` em tabela de conteúdo ou de transação, e existe backup mais recente que a perda.
- O engine é InnoDB e o erro é de corrupção de dados, não de credencial.
- Você está na terceira rodada de reparo na mesma tabela.
- A corrupção reapareceu depois de um reparo bem-sucedido. Isso indica causa de fundo (disco cheio, desligamento abrupto, hardware), e cada novo reparo só destrói mais linhas.
- O backup disponível é mais novo que a última alteração relevante do cliente. Se o backup é de ontem à noite e o cliente não publicou nada hoje, restaurar custa minutos e zero incerteza.

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.

## Duas mensagens prontas para avisar o cliente

Duas frases prontas, para copiar e adaptar.

Quando o reparo foi limpo:

> **** Identificamos tabelas corrompidas no banco de dados do seu site e executamos o reparo a partir do painel do servidor. O site voltou ao ar e as tabelas foram verificadas com resultado consistente. Não houve indicação de perda de registros. Recomendamos conferir as publicações e cadastros mais recentes nas próximas horas.

Quando houve perda:

> **** O banco de dados do seu site apresentou corrupção em uma ou mais tabelas. Executamos o reparo pelo painel do servidor e o site voltou a funcionar, mas o processo descartou registros que não puderam ser lidos. Pedimos que verifique os conteúdos e cadastros do período recente. Temos backup de [data] disponível caso prefira restaurar o estado anterior, com a perda do que foi criado depois dessa data.

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:

- **Backup com data verificada, não backup presumido.** Uma vez por mês, restaure um banco qualquer num subdomínio de teste. Backup que nunca foi restaurado é hipótese, não backup.
- **Monitorar espaço em disco da conta.** Partição ou cota cheia durante uma escrita é causa clássica de tabela MyISAM marcada como crashed.
- **Converter MyISAM remanescente para InnoDB em sites que você controla.** Tabela MyISAM não tem recuperação por log; InnoDB, apesar de não ser reparável por `REPAIR TABLE`, tem recuperação transacional e tende a sobreviver a um desligamento abrupto. Faça com backup na mão e fora do horário de pico.

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.

