Durante a instalação ou restauração do backup, o relatório do instalador pode incluir erros e avisos relacionados ao banco de dados. Esses erros geralmente estão associados a dados do arquivo de dump [hash]-dump.sql que não conseguem ser inseridos no novo banco de dados.

Este artigo explica os erros de banco de dados (SQL) que podem ocorrer durante a instalação e oferece um guia passo a passo sobre como resolvê-los.

Erros de Gravação

Consultas que geram erro durante a instalação são registradas no arquivo de log do instalador. Para revisar esses erros, abra o arquivo de log e procure pela seção intitulada “RESULTADOS DO BANCO DE DADOS”. Erros serão marcados com “**ERRO**”. As causas mais comuns incluem:

1. Versões do Banco de Dados: Incompatibilidades podem ocorrer se as versões do MySQL diferirem significativamente entre os servidores. Para minimizar problemas, certifique-se de que a versão do MySQL do servidor de destino seja similar ou superior à versão do servidor de build.
2. Modo MySQL: O Modo MySQL pode afetar como o motor MySQL processa as consultas. O instalador suporta a aplicação de NO_ENGINE_SUBSTITUTION e outros modos. Recomendamos definir inicialmente NO_ENGINE_SUBSTITUTION se muitos erros de banco de dados ocorrerem. Para fazer isso
3. Por padrão, o Duplicator pode estar usando um modo de instalação mais simples, que não exibe as opções avançadas.
   • Quando estiver na Etapa 1 do instalador, certifique-se de que está no Modo Avançado para acessar todas as configurações adicionais.
   • Na Etapa 1 do instalador, em Opções Avançadas, localize a configuração “Modo de Banco de Dados”.
   • Selecione o botão de rádio ‘Personalizar’ e insira NO_ENGINE_SUBSTITUTION.

• Continue com a instalação.
• Após a conclusão da instalação, verifique o log do instalador (link disponível no canto superior direito) em busca de erros.

Experimente várias combinações para determinar o que funciona melhor para o seu servidor. Assim que identificar uma configuração funcional, trabalhe com seu provedor ou administrador de servidor para definir esses valores permanentemente no arquivo my.ini.

Importante: Se você vir o texto “database error write ‘Invalid default value…’” no installer-log.txt, é uma indicação clara de que você precisa definir o modo MySQL para NO_ENGINE_SUBSTITUTION.

Erros de Limite de Tamanho de Consulta

Se você encontrar erros relacionados ao ‘Limite de tamanho de consulta’, isso significa que a carga de dados excede o que é permitido pela sua configuração MySQL. Você precisará postar os valores manualmente ou atualizar a configuração max_allowed_packet do seu servidor MySQL para lidar com cargas maiores. Se você estiver em um servidor hospedado, entre em contato com seu administrador de servidor. Mais detalhes podem ser encontrados na documentação sobre tamanho do pacote MySQL.

Para resolver isso sozinho, edite seu arquivo de configuração my.cnf (ou my.ini) e adicione ou atualize a configuração max_allowed_package_size=2M. Se essa configuração já existir, dobre seu valor atual. Certifique-se de reiniciar o servidor MySQL após fazer essas alterações.

Visão Geral do Relatório do Instalador

O relatório do instalador na etapa final foi projetado para destacar possíveis problemas com a instalação. Observe que, em alguns casos, você pode receber erros ou avisos que não afetam a funcionalidade geral do seu site. Se o seu site estiver estável e a contagem de resultados de Implantação/Atualização for baixa (abaixo de 10), você geralmente poderá ignorar esses erros ou avisos menores.

1. Erros de Atualização: Estas são instruções de consulta básicas que encontraram problemas durante a execução no novo servidor. Elas podem ser causadas por problemas de integridade de dados ou incompatibilidades entre diferentes versões do MySQL. Se erros aparecerem aqui, inspecione a consulta e depure o problema de migração.
2. Avisos de Chave de Tabela: Esses avisos ocorrem quando o novo valor de URL de uma tabela é detectado, mas não pode ser atualizado porque não há uma chave de tabela correspondente. Tais valores devem ser localizados e atualizados manualmente.
3. Avisos de Serialização: Problemas de serialização do PHP podem ocorrer quando valores internos mudam. Embora o Duplicator tente reparar essas strings serializadas, em alguns casos raros elas não são atualizadas corretamente.
   Erros de serialização podem acontecer por vários motivos. Para corrigir uma string serializada manualmente:
   1. Localize a string serializada problemática usando a consulta fornecida no relatório do instalador.
   2. Visite http://unserialize.onlinephpfunctions.com/.
   3. Na página, você pode ver uma string serializada de exemplo, como a:1:{s:4:"Test";s:17:"unserialize here!";}. Observe o segmento s:4:"Test"; – ele denota uma string com 4 caracteres. Se você alterar "Test" para "Tes" e executar, isso gerará um erro. Esse erro ocorre porque a contagem de caracteres numéricos está dessincronizada com o comprimento real da string.
   4. Ajuste a contagem de caracteres da string para corresponder ao seu comprimento real para corrigir o problema. Este método funciona se a string não foi corrompida por outra forma de codificação. Se foi, uma avaliação adicional de codificação pode ser necessária.

Verificação Rápida

Se você receber algum erro no relatório do instalador, siga estas etapas:

1. Verifique se o seu site está funcionando corretamente. Se o seu site estiver estável e a contagem de erros for baixa, você pode simplesmente precisar salvar novamente as configurações de um tema, plugin ou widget específico.
2. Se você ainda estiver preocupado, execute as consultas SQL fornecidas no relatório do instalador e revise o log de erros para avaliar consultas problemáticas. Você também pode realizar essa verificação usando phpMyAdmin.

Veja também:
Como corrigir problemas de gravação no banco de dados?
Como corrigir problemas de conexão com o banco de dados?
Provedores de hospedagem recomendados para Duplicator?