Lors de l'installation ou de la restauration de la sauvegarde, le rapport d'installation peut inclure des erreurs et des avertissements relatifs à la base de données. Ces erreurs sont généralement associées aux données de la base de données installer-data.sql qui ne parvient pas à être inséré dans la nouvelle base de données.

Cet article explique les erreurs de base de données (SQL) qui peuvent survenir lors de l'installation et propose un guide étape par étape pour les résoudre.

Erreurs d'écriture

Les requêtes qui s'avèrent erronées au cours de l'installation sont enregistrées dans le fichier journal du programme d'installation. Pour consulter ces erreurs, ouvrez le fichier journal et recherchez la section intitulée "DATABASE RESULTS". Les erreurs sont marquées par "**ERROR**". Les causes les plus courantes sont les suivantes :

1. Versions de la base de données : Des incompatibilités peuvent se produire si les versions de MySQL diffèrent considérablement d'un serveur à l'autre. Pour minimiser les problèmes, assurez-vous que la version MySQL du serveur de destination est similaire ou supérieure à celle du serveur de construction.
2. Mode MySQL : Le Mode MySQL peut affecter la manière dont le moteur MySQL traite les requêtes. Le programme d'installation prend en charge l'application de NO_ENGINE_SUBSTITUTION et d'autres modes. Nous recommandons de définir initialement NO_ENGINE_SUBSTITUTION si de nombreuses erreurs de base de données se produisent. Pour ce faire, il faut
   • À l'étape 1 du programme d'installation, sous Options avancées, repérez le paramètre "Mode MySQL".
   • Sélectionnez la case d'option "Personnalisé" et entrez NO_ENGINE_SUBSTITUTION.
     
   • Poursuivre l'installation.
   • Une fois l'installation terminée, vérifiez le journal du programme d'installation (lien disponible dans le coin supérieur droit) pour voir s'il y a des erreurs.

Expérimentez diverses combinaisons pour déterminer ce qui fonctionne le mieux pour votre serveur. Une fois que vous avez identifié une configuration qui fonctionne, travaillez avec votre hébergeur ou l'administrateur du serveur pour définir ces valeurs de manière permanente dans le fichier my.ini. Un exemple rapide de ce processus est fourni ici.

Important : Si vous voyez le texte "database error write 'Invalid default value..." dans le fichier installer-log.txt, cela indique clairement que vous devez définir le mode MySQL sur NO_ENGINE_SUBSTITUTION.

Erreurs de limitation de la taille des requêtes

Si vous rencontrez des erreurs liées à la "limite de taille des requêtes", cela signifie que la charge utile des données dépasse ce qui est autorisé par votre configuration MySQL. Vous devrez soit poster manuellement les valeurs, soit mettre à jour le paramètre max_allowed_packet de votre serveur MySQL afin de gérer des charges utiles plus importantes. Si vous êtes sur un serveur hébergé, contactez votre administrateur de serveur. Vous trouverez plus de détails dans la documentation sur la taille des paquets de MySQL.

Pour résoudre ce problème vous-même, éditez votre fichier de configuration my.cnf (ou my.ini) et ajoutez ou mettez à jour le paramètre max_allowed_package_size=2M. Si ce paramètre existe déjà, doublez sa valeur actuelle. Veillez à redémarrer le serveur MySQL après avoir effectué ces modifications.

Vue d'ensemble du rapport de l'installateur

Le rapport d'installation de la dernière étape est conçu pour mettre en évidence les problèmes potentiels liés à l'installation. Notez que dans certains cas, vous pouvez recevoir des erreurs ou des notifications qui n'affectent pas la fonctionnalité générale de votre site. Si votre site est stable et que le nombre de résultats de déploiement/mise à jour est faible (inférieur à 10), vous pouvez généralement ignorer ces erreurs ou notifications mineures.

1. Erreurs de mise à jour : Il s'agit d'instructions de requête de base qui ont rencontré des problèmes lors de leur exécution sur le nouveau serveur. Elles peuvent être dues à des problèmes d'intégrité des données ou à des incompatibilités entre les différentes versions de MySQL. Si des erreurs apparaissent ici, inspectez la requête et déboguez le problème de migration.
2. Avis sur la clé de table : Ces avis surviennent lorsque la nouvelle valeur URL d'une table est détectée mais ne peut pas être mise à jour parce qu'il n'y a pas de clé de table correspondante. Ces valeurs doivent être localisées et mises à jour manuellement.
3. Avis de sérialisation : PHP sérialisation peuvent se produire lorsque les valeurs internes changent. Bien que Duplicator tente de réparer ces chaînes sérialisées, dans certains cas rares, elles ne sont pas mises à jour correctement.
   Les erreurs de sérialisation peuvent survenir pour diverses raisons. Pour corriger manuellement une chaîne sérialisée :
   1. Localisez la chaîne sérialisée problématique à l'aide de la requête fournie dans le rapport d'installation.
   2. Visitez le site http://unserialize.onlinephpfunctions.com/.
   3. Sur la page, vous pouvez voir un exemple de chaîne sérialisée tel que a:1:{s:4:"Test";s:17:"unserialize here!";}. Remarquez le segment s:4:"Test"; - il s'agit d'une chaîne de 4 caractères. Si vous remplacez "Test" par "Tes" et que vous l'exécutez, une erreur se produira. Cette erreur se produit parce que le nombre de caractères numériques n'est pas synchronisé avec la longueur réelle de la chaîne.
   4. Ajustez le nombre de caractères de la chaîne pour qu'il corresponde à sa longueur réelle afin de résoudre le problème. Cette méthode fonctionne si la chaîne n'a pas été corrompue par une autre forme d'encodage. Si c'est le cas, une évaluation plus poussée de l'encodage peut être nécessaire.

Vérification rapide

Si le rapport d'installation contient des erreurs, procédez comme suit :

1. Vérifiez que votre site fonctionne correctement. Si votre site est stable et que le nombre d'erreurs est faible, il se peut que vous deviez simplement réenregistrer les paramètres d'un thème, d'un plugin ou d'un widget particulier.
2. Si vous êtes toujours inquiet, exécutez les requêtes SQL fournies dans le rapport d'installation et consultez le journal des erreurs pour évaluer les requêtes qui posent problème. Vous pouvez également effectuer cette vérification à l'aide de phpMyAdmin.

Voir aussi :
Comment résoudre les problèmes d'écriture dans la base de données ?
Comment résoudre les problèmes de connexion à la base de données ?
Fournisseurs d'hébergement recommandés pour Duplicator ?