blog
Revenda

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.

JR · · 7 min de leitura · 1 tabela · 2 blocos de código

Resposta curta: 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.

Neste artigo
  1. O que é o grupo SQL Services e por que ele assusta
  2. Mapa rápido: alcance, reinício e erro típico
  3. Quais telas do SQL Services afetam todas as contas do servidor
  4. Quais telas mexem em uma conta ou em um banco
  5. Por que a conexão externa ao banco falha
  6. Show MySQL Processes e phpMyAdmin do WHM: leitura rápida e risco de acesso root
  7. Checklist para mudar o grupo SQL sem derrubar sites

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 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
Antes de salvar: qual o alcance da tela?A tela altera o servidor inteiro?Se sim, é alteração globalSim: agende janela e avise clientesAtinge todas as contasNão: faça backup só do banco afetadoAlcance de uma contaReinicia o serviço de banco?Derruba sites por alguns segundosAnote os valores atuais antes de salvarPermite reverter só o que quebrouValide: serviço ativo e SELECT VERSION()Depois, teste uma página dinâmica
Decida o cuidado da mudança pelo alcance e pelo reinício, antes de clicar em salvar.

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:

  1. Faça backup completo dos bancos antes (não só o backup diário agendado).
  2. Liste os sites que não são WordPress ou têm código próprio. Esses são os candidatos a quebrar.
  3. Avise os clientes com janela de manutenção.
  4. 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.

Trocar senha de banco sem derrubar o siteTrocar a senha no WHMAfeta só a conta escolhidaAtualizar DB_PASSWORD no wp-config.phpSem isso, o site caiTestar a home do siteConfirme o login e a página inicial
Ordem para não deixar o site com a senha antiga gravada.

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:

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:

  1. Identifique o alcance pela tabela acima. Se for global, agende janela e avise clientes.
  2. Faça backup dos bancos afetados. Para alteração global, de todos.
  3. Anote o estado atual: valores de configuração, versão, lista de hosts.
  4. Aplique uma mudança por vez. Se algo quebrar, você sabe qual foi.
  5. Valide: serviço ativo, SELECT VERSION(); respondendo e uma página dinâmica de cada site crítico carregando.
  6. 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."

Referências

  1. Documentação oficial (cpanel) — SQL Services (WHM). Consultado em 2026-11-13.
Leia também