Durante a instalação ou restauro da cópia de segurança, o relatório do instalador pode incluir erros e avisos relacionados com a base de dados. Estes erros estão normalmente associados a dados do ficheiro [hash]-dump.sql ficheiro de despejo que não consegue ser inserido na nova base de dados.

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

Erros de escrita

As consultas que dão erro durante a instalação são registadas no ficheiro de registo do instalador. Para rever estes erros, abra o ficheiro de registo e procure a secção intitulada "RESULTADOS DA BASE DE DADOS". Os erros serão marcados com "**ERROR**". As causas mais comuns incluem:

1. Versões da base de dados: Podem ocorrer incompatibilidades se as versões do MySQL diferirem significativamente entre os servidores. Para minimizar os problemas, certifique-se de que a versão do MySQL do servidor de destino é semelhante ou superior à versão do servidor de compilação.
2. Modo MySQL: O Modo MySQL pode afetar a forma 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 ocorrerem muitos erros na base de dados. Para o fazer
3. Por defeito, o Duplicator pode estar a utilizar um modo de instalação mais simples, que não apresenta as opções avançadas.
   • Quando estiver no Passo 1 do instalador, certifique-se de que está no Modo Avançado para aceder a todas as definições adicionais.
   • No Passo 1 do instalador, em Opções avançadas, localize a definição "Modo de base de dados".
   • Selecionar o botão de opção "Personalizado" e introduzir NO_ENGINE_SUBSTITUTION.

• Continuar com a instalação.
• Após a conclusão da instalação, verifique se existem erros no registo do instalador (ligação disponível no canto superior direito).

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

Importante: Se vir o texto "database error write 'Invalid default value..." no installer-log.txt, é uma indicação clara de que precisa de definir o modo MySQL para NO_ENGINE_SUBSTITUTION.

Erros de limite de tamanho da consulta

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

Para resolver isto, edite o seu ficheiro de configuração my.cnf (ou my.ini) e adicione ou actualize a definição max_allowed_package_size=2M. Se esta definição já existir, duplique o 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 no passo final foi concebido para destacar potenciais problemas com a instalação. Note que, em alguns casos, poderá receber erros ou avisos que não afectam a funcionalidade geral do seu site. Se o seu site estiver estável e a contagem de resultados da implantação/atualização for baixa (abaixo de 10), normalmente é possível ignorar esses pequenos erros ou avisos.

1. Erros de atualização: Estas são instruções de consulta básicas que encontraram problemas durante a execução no novo servidor. Podem ser causados por problemas de integridade de dados ou incompatibilidades entre diferentes versões do MySQL. Se aparecerem erros aqui, inspeccione a consulta e depure o problema de migração.
2. Avisos de chave de tabela: Estes avisos ocorrem quando o novo valor de URL de uma tabela é detectado mas não pode ser atualizado porque não existe uma chave de tabela correspondente. Esses valores devem ser localizados e actualizados manualmente.
3. Avisos de serialização: PHP serialização podem ocorrer problemas quando os valores internos são alterados. Embora o Duplicator tente reparar estas cadeias de caracteres serializadas, em alguns casos raros elas não são actualizadas corretamente.
   Os erros de serialização podem ocorrer por vários motivos. Para corrigir manualmente uma cadeia de caracteres serializada:
   1. Localize a cadeia serializada problemática utilizando a consulta fornecida no relatório do instalador.
   2. Visite http://unserialize.onlinephpfunctions.com/.
   3. Na página, poderá ver uma amostra de uma cadeia de caracteres serializada, como a:1:{s:4:"Test";s:17:"unserialize here!";}. Observe o segmento s:4:"Test"; - representa uma cadeia de caracteres com 4 caracteres. Se alterar "Teste" para "Tes" e executar, será gerado um erro. Este erro ocorre porque a contagem de caracteres numéricos não está sincronizada com o comprimento real da cadeia.
   4. Ajuste a contagem de caracteres da cadeia de caracteres para corresponder ao seu comprimento real para corrigir o problema. Este método funciona se a cadeia de caracteres não tiver sido corrompida por outra forma de codificação. Se tiver sido, pode ser necessária uma avaliação adicional da codificação.

Verificação rápida

Se receber algum erro no relatório do instalador, siga estes passos:

1. Verifique se o seu site está a funcionar corretamente. Se o seu sítio estiver estável e a contagem de erros for baixa, poderá ser necessário voltar a guardar as definições de um determinado tema, plug-in ou widget.
2. Se continuar preocupado, execute as consultas SQL fornecidas no relatório do instalador e reveja o registo de erros para avaliar as consultas problemáticas. Também pode efetuar esta verificação utilizando o phpMyAdmin.

Veja também:
Como resolver problemas de escrita na base de dados?
Como resolver problemas de ligação à base de dados?
Fornecedores de alojamento recomendados para o Duplicator?