# Opções de banco de dados no WHM: o que cada tela altera

Para cada tela do grupo SQL Services: se atinge todas as contas ou uma só, se reinicia o MySQL e qual erro costuma aparecer depois, com checklist para quem administra servidor com várias contas.

> O grupo SQL Services do WHM tem telas de alcance global (configuração, upgrade e perfis do MySQL, que podem reiniciar o banco) e telas de uma conta só (senha de usuário, reparo, mapa de bancos). Saber qual é qual evita derrubar todos os sites.

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

---

## O que é o grupo SQL Services e por que ele assusta

No WHM, as telas de banco ficam reunidas no grupo **SQL Services** (no menu lateral, às vezes aparece como "SQL Services" mesmo com o painel em português). A [documentação oficial do cPanel](https://docs.cpanel.net/whm/sql-services/) lista cada tela separadamente, mas não responde o que interessa a quem administra um VPS ou servidor dedicado com várias contas: **essa tela mexe em todo mundo ou só numa conta? Vai reiniciar o MySQL? O que costuma quebrar depois?**

Este guia organiza o grupo por essas três perguntas. A maior parte dessas telas (Edit Database Configuration, Upgrade, Profiles, Root Password e o phpMyAdmin do WHM) exige acesso root, ou seja, VPS ou dedicado. Uma conta de revenda comum normalmente não as vê. Se esse é o seu caso, o guia serve para saber o que pedir ao provedor e o que esperar nos sites depois da mudança. Os nomes das telas podem variar um pouco entre versões do WHM e entre MySQL e MariaDB. Se a sua instalação mostrar um nome diferente, confira a descrição na documentação linkada acima antes de aplicar.

Uma observação de escopo: aqui não há medição da Napoleon. Tudo o que está descrito como comportamento das telas vem da documentação do cPanel. O que está descrito como erro comum vem da experiência de operação e está identificado como tal.

## Mapa rápido: alcance, reinício e erro típico

Use a tabela como checklist antes de clicar em salvar. A coluna "Alcance" é o que mais importa num servidor com várias contas: uma alteração global atinge contas que não são suas de manter.

| Tela | O que altera | Alcance | Reinicia o banco | Erro comum depois |
|---|---|---|---|---||
| Edit Database Configuration | Parâmetros do servidor MySQL/MariaDB (my.cnf) | Todas as contas | Sim | Serviço não sobe com valor inválido; sites fora do ar durante o reinício |
| MySQL/MariaDB Upgrade | Versão do servidor de banco | Todas as contas | Sim | Consulta antiga quebra por mudança de SQL mode ou sintaxe |
| MySQL Root Password | Senha do usuário root do banco | Servidor inteiro (ferramentas administrativas) | Não para os sites | Script externo ou backup com a senha antiga falha |
| Change MySQL User Password | Senha de um usuário de banco | Uma conta | Não | "Error establishing a database connection" no WordPress |
| Additional MySQL Access Hosts | Hosts autorizados a conectar remotamente | Servidor, com opção de propagar para contas | Não | Host is not allowed to connect (1130) ou timeout por firewall |
| Manage MySQL Profiles | Onde o cPanel cria e gerencia bancos novos (servidor local ou remoto) | Todas as contas | Não | Bancos novos criados em outro servidor; sites com localhost fixo continuam no banco local |
| Repair a MySQL Database | Tabelas de um banco | Um banco | Não | Tabela InnoDB que o reparo não resolve |
| Show MySQL Processes | Nada (leitura) | Servidor | Não | Nenhum |
| Database Map Tool | Associação de bancos existentes a uma conta | Uma conta | Não | Banco some do cPanel do cliente esperado |
| phpMyAdmin | Dados, conforme o que você executar | Depende da consulta | Não | Alteração acidental em banco de outra conta |
| PostgreSQL Config | Configuração de acesso do PostgreSQL | Servidor | Sim (PostgreSQL) | Conexão PostgreSQL recusada |

## Quais telas do SQL Services afetam todas as contas do servidor

### Edit Database Configuration: o que reinicia e por que o serviço pode não subir

Aqui ficam parâmetros como limites de conexão, tamanho de pacote e buffers. Salvar grava a configuração e reinicia o serviço de banco. Durante o reinício, todos os sites que dependem de banco no servidor ficam sem conexão por alguns segundos, e esse tempo cresce com o tamanho do buffer do InnoDB.

O erro mais caro é salvar um valor que o MySQL não aceita para aquela versão: o serviço não volta. Antes de mexer, anote os valores atuais. Depois, valide:

```
systemctl status mariadb
mysql -e "SELECT VERSION();"
```

Se o servidor usa MySQL em vez de MariaDB, o nome da unidade é `mysqld`. Se o serviço não subir, o log de erro do banco diz qual parâmetro foi rejeitado; reverta só esse.

Antes de aumentar limites para "resolver lentidão", olhe o log de consultas lentas da conta que reclamou. Muitas vezes o problema é uma consulta sem índice num plugin, e aumentar buffer só adia o sintoma.

### MySQL/MariaDB Upgrade: o que quebra depois da troca de versão

Troca a versão do servidor para todas as contas. A própria ferramenta avisa que não há caminho simples de volta. O que costuma quebrar depois não é o WordPress atualizado, e sim o site legado: sistema feito sob medida anos atrás, consulta com `GROUP BY` permissivo ou função removida.

Processo que funciona em servidor com várias contas:

- Faça backup completo dos bancos antes (não só o backup diário agendado).
- Liste os sites que não são WordPress ou têm código próprio. Esses são os candidatos a quebrar.
- Avise os clientes com janela de manutenção.
- Depois do upgrade, teste login e uma página com busca ou listagem em cada site da lista do passo 2.

### Manage MySQL Profiles: para onde vão os bancos novos

Define qual servidor MySQL o cPanel usa: o local ou um remoto. Ativar outro perfil muda, para o servidor inteiro, onde o cPanel cria e gerencia bancos novos, e bancos criados a partir daí nascem no servidor ativo. O serviço de banco não é reiniciado. Sites que têm `localhost` fixo no arquivo de configuração continuam procurando o banco local. Não é tela para testar; só ative perfil com plano de migração definido.

## Quais telas mexem em uma conta ou em um banco

### Change MySQL User Password: o que quebra no site depois

Troca a senha de um usuário de banco de uma conta. O banco continua igual, mas a aplicação ainda tem a senha antiga gravada. No WordPress, o resultado imediato é "Error establishing a database connection". Sempre atualize `DB_PASSWORD` no `wp-config.php` logo em seguida, e teste a home.

Frase pronta para o cliente: "Trocamos a senha de acesso do banco por segurança. Atualizamos o site junto, então nada muda para você; se algum sistema externo conecta no banco, ele precisa da senha nova."

### Repair a MySQL Database: quando o reparo resolve e quando não resolve

Roda o reparo nas tabelas de um banco específico, sem precisar da senha do cliente. Funciona bem em tabelas MyISAM marcadas como corrompidas. Em InnoDB, o reparo tem alcance limitado: se o erro persistir, o caminho é restaurar do backup, não insistir na tela.

### Database Map Tool: como associar o banco à conta certa

Associa bancos que existem no servidor a uma conta cPanel, útil quando um banco foi criado fora do painel ou veio de migração manual. O erro típico é mapear para a conta errada: o banco passa a aparecer num cPanel e some do outro. Confira o nome do usuário cPanel duas vezes antes de confirmar.

## Por que a conexão externa ao banco falha

### MySQL Root Password: quem depende da senha root

Troca a senha do root do banco. Os sites não usam root, então não caem. O que falha é tudo que você ou um terceiro configurou com root: script de backup externo, ferramenta de monitoramento, cliente SQL no seu notebook. Antes de trocar, liste onde a senha root está gravada fora do WHM.

### Additional MySQL Access Hosts: como testar a conexão remota

Define os hosts que podem conectar ao MySQL de fora do servidor. A documentação descreve a opção de levar esses hosts para as contas, aparecendo no **Remote MySQL** do cPanel de cada cliente. Dois erros aparecem depois:

- **Host is not allowed to connect** (erro 1130): o IP de origem não está na lista ou o usuário de banco não foi liberado para aquele host.
- **Timeout sem mensagem**: o host está liberado no MySQL, mas o firewall do servidor bloqueia a porta do banco.

Teste a partir da máquina remota:

```
mysql -h IP_DO_SERVIDOR -u usuario_banco -p -e "SELECT 1;"
```

Se responder `1`, a conexão está correta. Libere só os IPs necessários. Abrir para qualquer origem expõe todas as contas a tentativa de senha.

## Show MySQL Processes e phpMyAdmin do WHM: leitura rápida e risco de acesso root

**Show MySQL Processes** só mostra o que está rodando no banco, sem alterar nada. É a primeira tela para abrir quando o servidor fica lento: uma consulta presa há muito tempo, sempre do mesmo usuário, aponta a conta responsável. Isso resolve mais casos do que aumentar recursos do servidor.

**phpMyAdmin** no WHM, acessado como root, abre com visão administrativa, enxergando bancos de todas as contas. É o oposto do phpMyAdmin do cPanel, que só mostra os bancos daquela conta. Um `DROP` ou `UPDATE` sem `WHERE` executado aqui atinge o banco que estiver selecionado, seja de quem for. Para tarefa de um cliente só, prefira entrar pelo cPanel dele.

## Checklist para mudar o grupo SQL sem derrubar sites

Para padronizar entre vários servidores, salve este roteiro na documentação da agência:

- **Identifique o alcance** pela tabela acima. Se for global, agende janela e avise clientes.
- **Faça backup** dos bancos afetados. Para alteração global, de todos.
- **Anote o estado atual**: valores de configuração, versão, lista de hosts.
- **Aplique uma mudança por vez.** Se algo quebrar, você sabe qual foi.
- **Valide**: serviço ativo, `SELECT VERSION();` respondendo e uma página dinâmica de cada site crítico carregando.
- **Registre** o que mudou e quando. No próximo chamado de lentidão, esse registro economiza horas.

Frase pronta para mudanças globais: "Vamos fazer uma manutenção no banco de dados do servidor entre tal e tal horário. O site pode ficar indisponível por alguns minutos; conferimos tudo logo depois."

