Je souhaite résoudre l’échec des vérifications préalables à la mise à niveau qui s’affiche lorsque j’essaie de mettre à niveau mon instance de base de données Amazon Relational Database Service (Amazon RDS) for MySQL.
Brève description
Amazon RDS et Amazon Aurora édition compatible avec MySQL incluent des vérifications préalables automatiques qui minimisent toute durée d’indisponibilité imprévue lors d’une mise à niveau de version. Lorsque vous effectuez une mise à niveau de MySQL de la version [5.7 vers la version 8.0 ou de la version 8.0 vers la version 8.4](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.MySQL.Major.html#USER_UpgradeDBInstance.MySQL.80to84Prechecks), les vérifications préalables détectent toute incompatibilité de données susceptible d’affecter votre mise à niveau. En cas d’échec de vérification préalable á la mise à niveau sur votre instance de base de données, la mise à niveau de la version Amazon RDS for MySQL est interrompue. Amazon RDS fournit ensuite les détails de l’échec de vérification préalable dans le fichier journal PrePatchCompatibility.
Pour identifier et corriger le problème, consultez le fichier journal sous Journaux et événements dans la console Aurora et RDS.
Pour plus d’informations sur les vérifications préalables de MySQL, consultez la page Upgrade checker utility sur le site Web de MySQL.
Solution
Remarque : si des erreurs surviennent lorsque vous exécutez des commandes de l’interface de la ligne de commande AWS (AWS CLI), consultez la section Troubleshooting errors for the AWS CLI. Vérifiez également que vous utilisez la version la plus récente de l’AWS CLI.
Consultez le message d’échec de vérification préalable à la mise à niveau
Pour consulter votre fichier journal, procédez comme suit :
- Ouvrez la console Aurora et RDS.
- Dans le volet de navigation, choisissez Bases de données, puis sélectionnez la base de données que vous essayez de mettre à niveau.
- Sélectionnez l’onglet Journaux et événements, puis recherchez PrePatchCompatibility dans les événements récents.
- Examinez le fichier journal PrePatchCompatibility, puis remédiez au problème.
Remarque : Dans la plupart des cas, l’entrée du journal inclut un lien vers la documentation d’Amazon RDS for MySQL qui explique comment résoudre le problème d’incompatibilité.
Vérifiez si le message contient des erreurs, des avertissements et des notifications spécifiques
Dans le fichier journal PrePatchCompatibility, vous pouvez recevoir l’un des messages de vérification préalable suivants :
- « Usage of old temporal type : ERROR »
- « Usage of db objects with names conflicting with new reserved keywords : WARNING »
- « Usage of utf8mb3 charset : NOTICE »
- « Table names in the mysql schema conflicting with new tables in 8.0 : ERROR »
- « Partitioned tables using engines with non native partitioning : ERROR »
- « Foreign key constraint names longer than 64 characters : ERROR »
- « Usage of obsolete MAXDB sql_mode flag : WARNING »
- « Usage of obsolete sql_mode flags : NOTICE »
- « ENUM/SET column definitions containing elements longer than 255 characters : ERROR »
- « Usage of partitioned tables in shared tablespaces : ERROR »
- « Circular directory references in tablespace data file paths : ERROR »
- « Usage of removed functions : ERROR »
- « Usage of removed GROUP BY ASC/DESC syntax : ERROR »
- « Removed system variables for error logging to the system log configuration : ERROR »
- « Removed system variables : ERROR »
- « System variables with new default values : WARNING »
- « Schema inconsistencies resulting from file removal or corruption : ERROR »
- « Issues reported by 'check table x for upgrade' command : ERROR or WARNING or NOTICE »
- « The definer column for mysql.events cannot be null or blank : ERROR »
- « Tables with dangling FULLTEXT index reference : ERROR »
- « Routines with deprecated keywords in definition : ERROR »
- « DB instance must have enough free disk space : ERROR »
- « Creating indexes larger than 767 bytes on tables with redundant row format might cause the tables to be inaccessible : WARNING »
- « The tables with redundant row format can't have an index larger than 767 bytes : ERROR »
- « Column definition mismatch between InnoDB Data Dictionary and actual table definition : ERROR »
Si vous recevez un message de type ERROR, corrigez les erreurs avant d’essayer de procéder à la mise à niveau. Si vous recevez un message de type WARNING, cela signifie qu’Amazon RDS n’a détecté aucune erreur grave, mais a détecté des problèmes potentiels.
Si vous recevez un message de type NOTICE, cela signifie qu’Amazon RDS n’a détecté aucune erreur ou problème de compatibilité connu. Cependant, vérifiez le message NOTICE dans les journaux d’erreurs.
Répertoriez les fichiers journaux et téléchargez les données
Pour répertorier les fichiers journaux et télécharger les données, procédez comme suit :
-
Exécutez la commande describe-db-log-files de l’AWS CLI pour répertorier les fichiers journaux :
aws rds describe-db-log-files \
--db-instance-identifier DB_identifier \
--query '*[].[LogFileName]' \
--output text
Remarque : remplacez DB_identifier par le nom de la base de données dans laquelle se trouve le fichier journal.
Exemple de sortie :
PrePatchCompatibility.log
error/mysql-error.log
error/mysql-error-running.log
error/mysql-error-running.log.2023-05-06.3
error/mysql-error-running.log.2023-05-09.4
error/mysql-error-running.log.2023-05-10.3
error/mysql-error-running.log.2023-05-12.19
mysqlUpgrade
-
Exécutez la commande download-db-log-file-portion pour télécharger un fichier journal spécifique :
aws rds download-db-log-file-portion \
--db-instance-identifier DB_identifier \
--log-file-name PrePatchCompatibility.log \
--starting-token 0 \
--output text > LogFileName
Remarque : remplacez DB_identifier par le nom de la base de données dans laquelle se trouve le fichier journal. Remplacez LogFileName par le nom du fichier pour enregistrer une copie.
Exemple de sortie :
aws rds download-db-log-file-portion \
--db-instance-identifier testinstance \
--log-file-name PrePatchCompatibility.log \
--starting-token 0 \
--output text > PrePatchCompatibilityCopy.log
Informations connexes
Upgrading to MySQL 8.0? Here’s what you need to know sur le site Web de MySQL
Preparing your installation for upgrade sur le site Web de MySQL