blog
Painéis

Renomear banco de dados no cPanel sem quebrar o site

O painel renomeia em segundos e não avisa nada. Quem reclama é o WordPress, com a tela de erro de conexão, porque o wp-config.php ainda aponta para o nome antigo.

JR · · 8 min de leitura · 2 tabelas · 3 blocos de código

Resposta curta: renomear o banco no cPanel é seguro com backup antes e 4 passos: colocar o site em manutenção (opcional), usar o botão Rename em Bancos de Dados MySQL, atualizar DB_NAME no wp-config.php e reassociar o usuário com ALL PRIVILEGES. Sem o DB_NAME novo, o WordPress mostra erro de conexão com o banco.

Neste artigo
  1. O que o botão Rename faz e o que ele não faz
  2. Como identificar o banco certo quando a conta tem vários sites
  3. Backup antes, sem exceção
  4. A ordem dos passos que mantém o site fora do ar por segundos, não por minutos
  5. Renomear o usuário é outra operação, e quase sempre desnecessária
  6. Por que o erro aparece como mensagem do WordPress, e não do cPanel
  7. Três níveis de reversão, do mais barato ao mais caro
  8. O que confirmar antes de fechar o painel

Renomear um banco de dados no cPanel leva poucos segundos. O site cai no mesmo instante, porque o WordPress continua procurando o nome antigo no wp-config.php e recebe um erro do MySQL. A tela que aparece não é um aviso do painel: é a mensagem do próprio WordPress, Erro ao estabelecer conexão com o banco de dados.

A operação é segura quando feita na ordem certa. Fora de ordem, ela custa minutos de site fora do ar e uma reassociação de usuário que muita gente esquece.

O que o botão Rename faz e o que ele não faz

No cPanel, a ferramenta MySQL Databases (Bancos de Dados MySQL) tem, na lista de bancos existentes, uma ação Rename ao lado de cada banco. Segundo a documentação oficial do cPanel, a interface permite renomear bancos e usuários existentes, além de criar, remover e gerenciar privilégios.

O que o Rename faz:

O que ele não faz:

Em bancos grandes a operação pode demorar alguns segundos a mais: espere a página recarregar e não feche a aba no meio do processo.

Como identificar o banco certo quando a conta tem vários sites

Em conta com vários sites, renomear o banco errado é o acidente mais comum. Faça a conferência pelos dois lados.

O wp-config.php é a palavra final sobre qual banco o site usa

No Gerenciador de Arquivos do cPanel, entre na pasta do site (normalmente public_html ou public_html/pasta-do-site), clique com o botão direito em wp-config.php e escolha Editar. Procure a linha:

define( 'DB_NAME', 'usuario_wp01' );
define( 'DB_USER', 'usuario_wpuser' );
define( 'DB_PASSWORD', 'senha-atual' );
define( 'DB_HOST', 'localhost' );

O valor de DB_NAME é o banco que você vai renomear. Anote também DB_USER: é o usuário que precisará ser reassociado depois.

Como confirmar o banco pela lista Current Databases do cPanel

Em Bancos de Dados MySQL, a lista Current Databases mostra, para cada banco, o tamanho e os usuários com privilégio. Use as duas colunas como confirmação cruzada:

Sinal na lista O que ele indica
Nome igual ao DB_NAME É o banco do site, confirmado
Usuário associado igual ao DB_USER Confirmação dupla, pode seguir
Tamanho muito pequeno Pode ser banco de teste ou instalação abandonada
Nenhum usuário associado Banco órfão, provavelmente não é o do site no ar

Se dois bancos tiverem nomes parecidos (usuario_wp e usuario_wp2), o wp-config.php é a palavra final.

Backup antes, sem exceção

Renomear mexe na estrutura inteira do banco. Se a operação for interrompida, você quer ter um arquivo para restaurar.

Baixar o dump pela ferramenta Backup do cPanel

  1. Abra Backup (Backups) no painel.
  2. Na seção Download a MySQL Database Backup, clique no nome do banco.
  3. O navegador baixa um arquivo .sql.gz. Guarde fora do servidor.

Exportar o banco pelo phpMyAdmin

  1. Abra phpMyAdmin.
  2. Clique no banco na coluna da esquerda.
  3. Aba Exportar, método Rápido, formato SQL, botão Executar.

Faça também um backup dos arquivos, ou ao menos uma cópia do wp-config.php. No Gerenciador de Arquivos: botão direito no arquivo, Copiar, e salve como wp-config.php.bak na mesma pasta. Esse arquivo é o seu caminho de volta se você errar uma aspa na edição.

A ordem dos passos que mantém o site fora do ar por segundos, não por minutos

O site vai ficar indisponível entre o passo 2 e o passo 3. Faça os dois em sequência, com as duas abas já abertas. O backup da seção anterior já deve estar baixado antes de começar: ele não entra na contagem porque não é opcional.

Modo manutenção evita que o visitante veja o erro

Opcional, mas evita que visitantes vejam o erro de conexão. Um plugin de modo manutenção resolve. Se não tiver, apenas escolha um horário de pouco acesso.

Renomeando o banco sem perder o prefixo da conta

  1. Em Bancos de Dados MySQL, encontre o banco na lista Current Databases.
  2. Clique em Rename na linha dele.
  3. Digite o nome novo. Lembre que o prefixo da conta é mantido automaticamente: você digita só a parte final.
  4. Confirme e espere a página recarregar. Não feche a aba.

Use apenas letras minúsculas, números e sublinhado. Evite hífen e acento.

Trocando o DB_NAME no wp-config.php pelo nome novo

  1. Volte ao Gerenciador de Arquivos, abra wp-config.php em Editar.
  2. Troque o valor de DB_NAME pelo nome novo completo, com prefixo:
define( 'DB_NAME', 'usuario_wpnovo' );
  1. Salve. Atenção às aspas simples e ao ponto e vírgula no fim da linha.
  2. Abra o site em aba anônima e recarregue.

Se o site voltar, falta apenas a verificação de privilégios do passo seguinte. Se não voltar, vá direto para a seção de erros.

Reassociando o usuário com ALL PRIVILEGES

Na própria tela Bancos de Dados MySQL, role até Current Databases e olhe a coluna de usuários privilegiados do banco renomeado. Se o usuário do site não estiver lá:

  1. Vá até a seção Add User To Database.
  2. Escolha o usuário em User e o banco novo em Database.
  3. Clique em Add.
  4. Na tela Manage User Privileges, marque ALL PRIVILEGES e confirme.

O WordPress precisa de privilégios amplos no banco para atualizar o próprio núcleo, instalar plugins e criar tabelas. Conceder só SELECT faz o site abrir e quebrar na primeira escrita.

Ordem que mantém o site fora por segundosBackupDump do banco e wp-configModo manutençãoOpcional, evita erro visívelRename no cPanelPrefixo da conta é mantidoTrocar DB_NAMENome novo com prefixoReassociar usuárioAdd User, ALL PRIVILEGES
O site fica fora do ar apenas entre o Rename e a edição do wp-config.php.

Renomear o usuário é outra operação, e quase sempre desnecessária

A mesma tela permite renomear usuários MySQL. A documentação do cPanel trata usuários e bancos como objetos separados, com gerenciamento de privilégios próprio entre eles.

Consequência prática: o privilégio é um vínculo entre um usuário e um banco. Quando o nome de um dos dois muda, o vínculo pode deixar de existir e precisa ser refeito em Add User To Database. Depois de renomear o usuário, você ainda tem que:

  1. Atualizar DB_USER no wp-config.php com o nome novo, incluindo o prefixo.
  2. Reassociar o usuário ao banco com ALL PRIVILEGES.

A senha não muda ao renomear o usuário, então DB_PASSWORD continua válida. Se você não tem certeza da senha, defina uma nova em Change Password na seção de usuários e atualize o wp-config.php com ela.

Recomendação contra o óbvio: na maioria das migrações, não renomeie o usuário. Renomeie só o banco. Um passo a menos é uma chance a menos de quebrar.

Por que o erro aparece como mensagem do WordPress, e não do cPanel

O cPanel considera a renomeação bem-sucedida assim que o MySQL responde. Ele não conhece seus arquivos PHP. Quem descobre o problema é o WordPress, na primeira requisição: ele lê DB_NAME, tenta conectar, o MySQL responde que aquele banco não existe ou que o usuário não tem acesso, e o WordPress imprime a tela de erro genérica.

Por isso a mensagem é sempre a mesma para causas diferentes. Use esta tabela para separar:

Sintoma Causa provável Correção
Erro ao estabelecer conexão logo após o Rename DB_NAME ainda com o nome antigo Atualize DB_NAME com o nome novo e prefixo
Erro mesmo com DB_NAME correto Usuário sem privilégio no banco novo Add User To Database com ALL PRIVILEGES
Site abre, mas plugin ou atualização falha ao gravar Privilégio parcial, sem INSERT/UPDATE/CREATE Refaça os privilégios marcando ALL PRIVILEGES
Tela branca em vez da mensagem de erro Erro de sintaxe no wp-config.php Restaure wp-config.php.bak e refaça a edição
Erro só no /wp-admin Cache de objeto ou plugin de cache com dados antigos Renomeie a pasta do plugin de cache em wp-content/plugins

Para ver o erro real em vez da mensagem genérica, ative o log temporariamente no wp-config.php, acima da linha que diz para parar de editar:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

O WordPress grava em wp-content/debug.log. Abra pelo Gerenciador de Arquivos, leia a última linha, corrija e desative o debug depois, voltando os valores para false. Deixar ligado expõe caminhos do servidor.

Três níveis de reversão, do mais barato ao mais caro

Se algo der errado e você precisar desfazer, existem três níveis de reversão. Comece pelo mais barato.

Desfazer o Rename e voltar o DB_NAME junto

Renomeie o banco de volta para o nome antigo pela mesma tela. Se você já tinha alterado o DB_NAME no passo 3, volte o valor para o nome antigo também: os dois precisam bater. Confirme a associação do usuário depois, porque ela pode ter se perdido na ida e na volta.

Restaurar o wp-config.php sem apagar a versão quebrada

Se a edição do arquivo quebrou o site (tela branca, erro de sintaxe), não apague nada. No Gerenciador de Arquivos, renomeie o wp-config.php atual para wp-config.php.ruim e só então renomeie wp-config.php.bak para wp-config.php. Assim você mantém as duas cópias das credenciais caso o .bak esteja incompleto ou desatualizado. Com o site de volta, confira se o .bak restaurado tem senha e usuário corretos, compare com o .ruim se precisar, e refaça a alteração com calma, uma linha só.

Importar o dump em um banco novo

Se o banco ficou inconsistente, crie um banco novo em Bancos de Dados MySQL, associe o usuário com ALL PRIVILEGES, entre no phpMyAdmin, selecione o banco novo, aba Importar, envie o .sql do backup e aponte DB_NAME para ele. Esse é o motivo de o backup vir antes de tudo.

Três níveis de reversão, do barato ao caroMais baratoRenomear banco de volta e ajustar DB_NAMEIntermediárioRestaurar wp-config.php.bak sem apagar o quebr…Mais caroCriar banco novo e importar o dump
Tente sempre o nível de cima antes de passar para o próximo.

O que confirmar antes de fechar o painel

Antes de fechar o painel, confirme na ordem:

  1. DB_NAME no wp-config.php bate exatamente com o nome que aparece na lista do cPanel, prefixo incluído.
  2. DB_USER aparece na coluna de usuários privilegiados daquele banco.
  3. O usuário tem ALL PRIVILEGES.
  4. O site abre em aba anônima.
  5. O /wp-admin abre e você consegue salvar uma alteração qualquer, por exemplo o título do site em Configurações, Geral. Isso prova que a escrita funciona.
  6. Debug desativado e backup guardado fora do servidor.
  7. Se o site usa cache, limpe o cache do plugin e do servidor.

Um detalhe que só aparece depois: instalações que guardam credenciais fora do wp-config.php. Alguns plugins de backup, de busca externa ou de staging gravam o nome do banco em arquivos de configuração próprios. Se algo específico parar de funcionar dias depois da renomeação, procure o nome antigo dentro de wp-content pela busca do Gerenciador de Arquivos.

Fonte consultada para o comportamento da interface e para o gerenciamento de bancos, usuários e privilégios: cPanel, Manage My Databases, consultado em 18 de outubro de 2026. Os nomes usuario_wp01 e usuario_wpnovo usados aqui são exemplos fictícios; o prefixo real é o da sua conta.

Referências

  1. Documentação oficial (cpanel) — Manage My Databases. Consultado em 2026-10-18.
Leia também