Como Atualizar o Banco de Dados do WordPress (+ Corrigir o Loop de "Atualização Necessária")

Você atualizou o WordPress e agora seu painel não para de dizer que o banco de dados também precisa de uma atualização.

Você clica no botão. Ele diz “Nenhuma atualização necessária, seu banco de dados já está atualizado.” Então você recarrega a página e a mesma mensagem volta.

Isso acontece com mais frequência do que as pessoas imaginam, e nem sempre é óbvio o porquê.

Às vezes, é um problema de cache ou uma incompatibilidade de versão entre seus arquivos do WordPress e seu banco de dados. Outras vezes, é uma tabela corrompida que tem sido silenciosamente um problema por meses e só agora está bloqueando algo.

Neste guia, vou guiá-lo pelo processo de atualização padrão primeiro e, em seguida, cobrir maneiras de corrigir o loop se você estiver preso nele.

Também mostrarei como verificar a integridade do seu banco de dados antes de atualizar, para que você tenha menos chances de encontrar isso em primeiro lugar.

Aqui estão os principais pontos:

• A atualização de painel com um clique lida com o banco de dados automaticamente; os Métodos 2 e 3 (forçar via URL, WP-CLI) são necessários apenas para atualizações manuais de arquivos ou redes de Multisite
• O loop de “atualização necessária” raramente é um problema real do banco de dados. Na maioria das vezes, é um cache de objeto desatualizado ou um plugin de cache servindo uma tela de administração desatualizada, corrigível em minutos
• Uma verificação de integridade antes de atualizar pode prevenir o loop inteiramente. O overhead da tabela e problemas estruturais que o DB Optimizer sinaliza são um motivo comum para as atualizações ficarem presas no meio do caminho
• Atualizações de banco de dados e configuração de banco de dados são coisas diferentes — atualizações de esquema acontecem automaticamente após uma atualização principal; detalhes de conexão em wp-config.php só precisam ser alterados após uma migração
• Sempre faça backup com o Duplicator antes de atualizar. Se um conflito de plugin quebrar algo durante a atualização, restaurar a partir do backup é mais rápido do que solucionar problemas às cegas

Sumário

Por que Atualizar Seu Banco de Dados do WordPress?

Cada atualização do core do WordPress pode incluir alterações na estrutura do banco de dados, não apenas no código. Novos recursos às vezes precisam de novas tabelas, novas colunas ou alterações na forma como os dados existentes são organizados.

Quando você atualiza o WordPress, os arquivos principais são atualizados primeiro. Em seguida, se a nova versão precisar de alterações no banco de dados, o WordPress mostrará um aviso pedindo para você atualizar o banco de dados também.

Se você pular esta etapa, acabará executando o novo código do WordPress contra uma estrutura de banco de dados antiga. Plugins que dependem do novo esquema geram erros. Algumas telas de administração param de carregar corretamente.

Em alguns casos, o site permanece utilizável, mas recursos específicos falham silenciosamente.

A atualização do banco de dados em si geralmente é rápida. É a parte de ficar preso que leva tempo, e é por isso que a maior parte deste guia é sobre prevenção e solução de problemas, em vez da atualização em si.

Antes de atualizar seu banco de dados do WordPress

Duas coisas antes de tocar na página de Atualizações: faça backup de tudo e verifique a integridade atual do seu banco de dados.

Pular qualquer um deles torna a solução de problemas mais necessária.

Etapa 1: Faça Backup Completo do Seu Site

Antes de atualizar seu banco de dados do WordPress, crie um backup completo do seu site. Isso inclui seu banco de dados, arquivos e quaisquer outros dados importantes.

Ter um backup recente e confiável permitirá que você restaure seu site facilmente se algo der errado durante o processo de atualização.

Para fazer isso, recomendo usar o Duplicator. Ao contrário de outros plugins de backup, ele pode restaurar seu site ao normal, mesmo que esteja completamente offline.

Abra o Duplicator no seu painel do WordPress e crie um novo backup. Para uma atualização de core, faça backup do seu site completo, não apenas do banco de dados.

As atualizações de core tocam em arquivos e no banco de dados, então um backup apenas do banco de dados não será suficiente se a atualização de arquivos causar um problema.

Nomeie o backup com algo que você reconhecerá mais tarde e escolha um local de armazenamento. Se você tiver armazenamento em nuvem conectado (como Duplicator Cloud), o Duplicator pode enviar o backup para lá automaticamente.

Assim que o backup for concluído, você o verá listado na página Backups. Esse é o seu ponto de restauração caso algo dê errado nas próximas etapas.

Apenas por precaução, é uma boa ideia definir este backup como o ponto de recuperação de desastres. Clique no ícone da casa azul.

Depois de definir a recuperação de desastres, você terá duas maneiras diferentes de restaurar seu site. Copie o link de recuperação ou baixe o arquivo do launcher.

Se você ficar completamente bloqueado do seu painel de administração, cole o link de recuperação em uma janela do navegador. Ou, abra o arquivo do launcher. O Duplicator restaurará automaticamente este backup que você acabou de criar.

Eu faço isso antes de cada atualização de core, mesmo as menores. Os cinco minutos que leva não são nada comparados a solucionar um site quebrado sem um backup.

Etapa 2: Execute uma Verificação de Integridade do Banco de Dados com o DB Optimizer

Esta etapa captura o que o processo de atualização padrão não verifica: um banco de dados que já possui problemas antes mesmo de você começar.

Antes de atualizar, vamos limpar seu banco de dados com o DB Optimizer. Este plugin é gratuito com o Duplicator Pro.

A primeira coisa que você verá é uma pontuação de saúde de 0 a 100, dividida em cinco áreas: Sobrecarga de Tabela, Transientes, Revisões, Tamanho Autoload e Itens na Lixeira.

Você está procurando uma coisa em particular aqui: sobrecarga de tabela. Se essa barra estiver amarela ou vermelha, geralmente significa que uma ou mais tabelas acumularam espaço desperdiçado ou, em alguns casos, problemas estruturais de operações incompletas.

Um banco de dados com problemas em nível de tabela tem maior probabilidade de encontrar problemas durante uma atualização de esquema. Se uma tabela que a atualização precisa modificar já estiver em mau estado, a atualização pode falhar no meio do processo, que é uma das maneiras pelas quais as pessoas ficam presas no loop que mencionei anteriormente.

Abra a aba Cleanup e execute todas as otimizações disponíveis.

Em seguida, vá para a aba Tables. Otimize quaisquer tabelas com sobrecarga.

Assim que sua pontuação de saúde parecer razoável e a sobrecarga de tabela estiver limpa, você estará pronto para atualizar!

Como atualizar seu banco de dados do WordPress

Existem três maneiras de executar uma atualização de banco de dados do WordPress. Veja o que você fará:

• Método 1: A atualização com um clique no painel: o caminho padrão para a maioria das atualizações, onde o WordPress solicita automaticamente após uma atualização de core
• Método 2: Forçar a atualização via URL: para quando você atualizou os arquivos do WordPress manualmente e o prompt do banco de dados não aparece sozinho
• Método 3: Usar WP-CLI: para atualizar o banco de dados da linha de comando, útil para redes Multisite ou quando o método do painel não carrega

A maioria das pessoas só precisa do Método 1. Os outros dois estão lá para as situações em que o Método 1 não se aplica ou não funciona.

Método 1: A Atualização de Painel com Um Clique

Geralmente, atualizar bancos de dados do WordPress é um processo fácil. Comece atualizando seu site para a versão mais recente do WordPress. Você pode fazer isso na página Updates.

Se o seu banco de dados também precisar de atualização, um aviso aparecerá. Clique em Atualizar Banco de Dados do WordPress.

Quando terminar, você verá uma mensagem de sucesso e um botão Continue. Clique nele e você voltará ao seu painel normalmente.

Se nenhuma alteração no banco de dados foi necessária para essa versão, você não verá esta tela. Isso é normal. Nem toda atualização principal inclui alterações no banco de dados.

Método 2: Forçar a Atualização do Banco de Dados via URL

Use isso se você atualizou seus arquivos do WordPress manualmente, via FTP ou no gerenciador de arquivos da sua hospedagem, e o prompt de atualização do banco de dados nunca apareceu.

Abra seu navegador e acesse diretamente: seusite.com/wp-admin/upgrade.php

Certifique-se de atualizar isso com o URL do seu site. O WordPress informará se o seu banco de dados está atualizado.

Método 3: Usar WP-CLI

Se você tem acesso SSH ao seu servidor, o WP-CLI oferece a maneira mais rápida de executar uma atualização de banco de dados, e é especialmente útil se o painel não estiver carregando corretamente.

Conecte-se ao seu servidor via SSH e navegue até o diretório raiz do seu WordPress:

cd /path/to/your/wordpress

Em seguida, execute:

wp core update-db

Isso atualiza o banco de dados para uma instalação de site único. Você verá uma mensagem de confirmação quando terminar.

Se você está gerenciando uma rede Multisite, use isso em vez disso para atualizar todos os sites da rede de uma vez:

wp core update-db --network

O WP-CLI fornece saída direta, então se algo falhar, você verá uma mensagem de erro. Isso o torna útil para diagnosticar problemas, mesmo que você acabe corrigindo-os pelo painel.

Como corrigir o loop de "Atualização Necessária" do banco de dados do WordPress

Ao atualizar o banco de dados do WordPress, você pode ficar preso em um loop de "atualização de banco de dados necessária". Isso acontece quando o WordPress detecta que seu banco de dados precisa de uma atualização, mas, por algum motivo, o processo de atualização não é concluído com sucesso.

Se esse erro ocorrer, o WordPress solicitará continuamente que você atualize o banco de dados a cada carregamento de página, criando um loop infinito.

Vamos começar verificando se o valor db_version em seu banco de dados é o mesmo do arquivo version.php.

No cPanel, abra Bancos de Dados » phpMyAdmin. Selecione seu banco de dados e clique na tabela wp_options. Anote o option_value para db_version.

Em seguida, abra os arquivos do seu site. Vá para o diretório wp-include e encontre o arquivo version.php. Neste arquivo, você deverá ver uma linha como esta:

$wp_db_version = 57155;

Certifique-se de que esses valores sejam os mesmos. Talvez seja necessário atualizar seu arquivo version.php.

Outra maneira de corrigir esse erro é encontrar o arquivo object-cache.php em seu diretório wp-content. Exclua ou renomeie este arquivo.

Se isso não funcionou, o problema pode ser um problema no nível da tabela que está impedindo a conclusão da atualização. Você pode usar o DB Optimizer para reparar tabelas do banco de dados!

Como atualizar a configuração do banco de dados do WordPress

Você também pode precisar atualizar os detalhes da conexão do banco de dados do WordPress no arquivo de configuração do seu site (wp-config.php). Este arquivo contém as credenciais e configurações necessárias para o WordPress se conectar ao seu banco de dados.

O arquivo wp-config.php está localizado no diretório raiz da sua instalação do WordPress. Dentro deste arquivo, você encontrará os seguintes detalhes de conexão do banco de dados:

• DB_NAME: O nome do seu banco de dados WordPress
• DB_USER: O nome de usuário usado para acessar seu banco de dados WordPress
• DB_PASSWORD: A senha usada para acessar seu banco de dados WordPress
• DB_HOST: O host ou servidor onde seu banco de dados WordPress está localizado

Esses valores podem mudar se você migrou seu site para um novo host ou servidor. Você precisará atualizar seu banco de dados WordPress após as migrações.

É importante ter muito cuidado ao modificar o arquivo wp-config.php, pois um único erro de digitação pode impedir que seu site se conecte ao banco de dados. Sempre faça um backup do seu arquivo wp-config.php antes de fazer qualquer alteração.

Para verificar as configurações de configuração do seu banco de dados WordPress, abra o phpMyAdmin. Selecione seu banco de dados.

Verifique a primeira parte dos nomes das tabelas para obter o prefixo do seu banco de dados. Provavelmente será wp_.

Volte para a seção Bancos de Dados e clique em MySQL Databases.

Encontre seu banco de dados atual. Anote o nome de usuário e a senha dele.

Agora você pode abrir seu arquivo wp-config.php. Edite o nome do banco de dados, o usuário e a senha com as informações que você acabou de descobrir.

Defina o DB_Host como localhost. Adicione também o prefixo da sua tabela.

Depois disso, salve o arquivo.

Se você não tiver certeza de como atualizar corretamente a configuração do banco de dados, é melhor consultar seu provedor de hospedagem ou um desenvolvedor WordPress. Configurar incorretamente a conexão do seu banco de dados pode levar a problemas sérios em seu site.

Perguntas Frequentes (FAQs)

A redefinição do seu banco de dados WordPress deve ser sempre feita com extremo cuidado, pois apagará todo o conteúdo, configurações e dados de usuário do seu site. Tente redefinir o banco de dados apenas se você tiver um backup completo do seu site que possa restaurar.

Seu Banco de Dados Está Atualizado, Veja o Que Observar a Seguir

Seu banco de dados do WordPress agora está executando a versão atual, correspondendo aos seus arquivos principais atualizados. Seu site continua funcionando exatamente como antes, apenas em uma base atualizada.

Fique de olho nos plugins após uma atualização principal, especialmente nos dias logo em seguida. Alguns plugins enviam suas próprias alterações de banco de dados que são executadas independentemente da atualização principal do WordPress, e essas podem apresentar problemas um ou dois dias depois.

Execute novamente uma verificação de integridade do DB Optimizer após a atualização. Alguns processos de atualização deixam para trás dados temporários ou sobrecarga adicional. Uma verificação rápida pós-atualização (e limpeza, se necessário) ajuda você a começar de uma linha de base limpa.

Cada atualização de banco de dados acarreta algum risco, mesmo que pequeno. A diferença entre uma correção rápida e uma tarde estressante geralmente se resume a ter ou não um backup que você possa realmente restaurar.

Mais de 1,5 milhão de profissionais de WordPress usam o Duplicator para fazer backup de seus sites antes de cada atualização, migração e alteração importante. O DB Optimizer está incluído no Duplicator Pro, para que você possa verificar a integridade do seu banco de dados e fazer backup antes de cada atualização.

Enquanto você está aqui, acho que você vai gostar destes guias extras do WordPress:

• Como a Black Bike Media Resgatou um Banco de Dados Corrompido de 2,4 GB
• Como Otimizar o Banco de Dados do WordPress: Tenha um Site Rápido em 10 Passos
• Como Copiar um Banco de Dados WordPress (4 Métodos)
• 13 Melhores Plugins de Banco de Dados do WordPress para Gerenciamento Fácil de Dados
• WordPress 101: Como Criar um Banco de Dados WordPress