Lors de l'installation ou de la restauration de la sauvegarde, le rapport de l'installeur peut contenir des erreurs et des avertissements liés à la base de données. Ces erreurs sont généralement associées aux données du fichier de vidage [hash]-dump.sql qui ne parviennent pas à être insérées dans la nouvelle base de données.

Cet article explique les erreurs de base de données (SQL) qui peuvent survenir pendant l'installation et propose un guide étape par étape sur la façon de les résoudre.

Erreurs d'écriture

Les requêtes qui génèrent des erreurs pendant l'installation sont enregistrées dans le fichier journal de l'installeur. Pour examiner ces erreurs, ouvrez le fichier journal et recherchez la section intitulée « RÉSULTATS DE LA BASE DE DONNÉES ». Les erreurs seront marquées de « **ERREUR** ». Les causes les plus courantes incluent :

1. Versions de la base de données : Des incompatibilités peuvent survenir si les versions de MySQL diffèrent considérablement entre les serveurs. 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 façon dont le moteur MySQL traite les requêtes. L'installeur 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 surviennent. Pour ce faire
3. Par défaut, Duplicator peut utiliser un mode d'installation plus simple, qui n'affiche pas les options avancées.
   • Lorsque vous êtes à l'étape 1 de l'installeur, assurez-vous d'être en Mode Avancé pour accéder à tous les paramètres supplémentaires.
   • À l'étape 1 de l'installeur, sous Options avancées, localisez le paramètre « Mode de base de données ».
   • Sélectionnez le bouton radio « Personnalisé » et entrez PAS DE SUBSTITUTION DE MOTEUR.

• Poursuivez l'installation.
• Une fois l'installation terminée, vérifiez le journal de l'installeur (lien disponible dans le coin supérieur droit) pour les erreurs.

Expérimentez avec diverses combinaisons pour déterminer ce qui fonctionne le mieux pour votre serveur. Une fois que vous avez identifié une configuration fonctionnelle, travaillez avec votre hébergeur ou administrateur système pour définir ces valeurs de manière permanente dans le fichier my.ini.

Important : Si vous voyez le texte « erreur de base de données écriture 'Valeur par défaut invalide...' » dans le fichier installer-log.txt, c'est une indication claire que vous devez définir le mode MySQL sur NO_ENGINE_SUBSTITUTION.

Erreurs de limite de taille de requête

Si vous rencontrez des erreurs liées à la « limite de taille de requête », cela signifie que la charge de 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 pour gérer des charges plus importantes. Si vous êtes sur un serveur hébergé, contactez votre administrateur système. Plus de détails peuvent être trouvés dans la documentation sur la taille des paquets MySQL.

Pour résoudre ce problème vous-même, modifiez 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. Assurez-vous de redémarrer le serveur MySQL après avoir effectué ces modifications.

Aperçu du rapport d'installation

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

1. Erreurs de mise à jour : Ce sont des instructions de requête de base qui ont rencontré des problèmes lors de leur exécution sur le nouveau serveur. Elles peuvent être causées par des problèmes d'intégrité des données ou des incompatibilités entre différentes versions de MySQL. Si des erreurs apparaissent ici, inspectez la requête et déboguez le problème de migration.
2. Notifications de clés de table : Ces notifications se produisent lorsqu'une nouvelle valeur d'URL d'une table est détectée mais ne peut pas être mise à jour car 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 : Des problèmes de sérialisation PHP  peuvent survenir lorsque les valeurs internes changent. Bien que Duplicator tente de réparer ces chaînes sérialisées, dans de rares cas, elles ne sont pas mises à jour correctement.
   Les erreurs de sérialisation peuvent se produire 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 http://unserialize.onlinephpfunctions.com/.
   3. Sur la page, vous pourriez voir une chaîne sérialisée d'exemple telle que a:1:{s:4:"Test";s:17:"unserialize here!";}. Remarquez le segment s:4:"Test"; – il désigne une chaîne de 4 caractères. Si vous changez « Test » en « Tes » et exécutez, cela générera une erreur. 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 supplémentaire de l'encodage peut être nécessaire.

Vérification rapide

Si vous recevez des erreurs dans le rapport d'installation, suivez ces étapes :

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

Voir aussi :
Comment corriger les problèmes d'écriture de base de données ?
Comment corriger les problèmes de connexion à la base de données ?
Hébergeurs recommandés pour Duplicator ?