Comment puis-je réparer une instance de base de données Amazon RDS qui est bloquée à l'état incompatible-parameters ?

Date de la dernière mise à jour : 08/09/2020

Mon instance Amazon Relational Database Service (Amazon RDS) est bloquée à l'état incompatible-parameters. Je ne peux pas me connecter à l'instance de base données ni la modifier. Tout ce que je peux faire est de la supprimer ou la redémarrer. Comment puis-je résoudre ce problème ?

Brève description

Lorsqu'une instance de base de données RDS est à l'état incompatible-parameters, au moins l'un des paramètres du groupe associé est défini avec une valeur qui n'est pas compatible avec la version actuelle du moteur ou la classe d'instance de base de données.

Ceci peut être causé par :

  • Une instance de base de données qui est mise à l'échelle pour utiliser un type d'instance avec moins de mémoire disponible que la précédente. Au moins l’un des paramètres de mémoire du groupe de paramètres associé dépasse la taille de mémoire disponible pour l'instance de base de données actuelle.
  • Un moteur de base de données mis à niveau vers une version différente. Le moteur n'est plus compatible avec un ou plusieurs paramètres du groupe de paramètres personnalisés actuel.

Les configurations peuvent échouer si vous essayez d'associer un groupe de paramètres différent, de mettre à l'échelle le type d'instance de base de données ou de modifier la version du moteur ou la configuration de l'instance de base de données. Pour accepter une nouvelle configuration, les instances de base de données doivent être à l'état available. Si l'instance de base de données est à l’état incompatible-parameters, vous pouvez uniquement la redémarrer ou la supprimer.

Pour savoir comment déterminer quelles valeurs sont incompatibles, consultez la section Comment puis-je identifier les paramètres de base de données Amazon RDS qui appartiennent aux groupes de paramètres personnalisé et ceux qui appartiennent aux groupes par défaut ?

Résolution

Remarque : si vous recevez des erreurs lors de l'exécution de commandes à partir de l'interface de ligne de commande AWS (AWS CLI), assurez-vous d'utiliser la version la plus récente d'AWS CLI.

Pour résoudre ce problème, changez la valeur de chaque paramètre incompatible à une valeur compatible en utilisant l'une des options suivantes :

  • Réinitialisez tous les paramètres du groupe de paramètres à la valeur par défaut.
  • Réinitialisez les valeurs des paramètres qui ne sont pas compatibles.

Remarque : toutes les instances de base de données associées au groupe de paramètres incompatibles sont affectées par ces modifications de valeur. Pour sauvegarder les paramètres du groupe de paramètres actuels, copiez le groupe de paramètres avant de réinitialiser les paramètres.

Pour identifier la cause profonde du problème, vous pouvez copier le groupe de paramètres incompatible, puis comparer les différences entre les valeurs des paramètres personnalisés et les valeurs par défaut.

Vous pouvez utiliser AWS CloudTrail pour vérifier les modifications apportées à votre groupe de paramètres personnalisés. Filtrez le nom de l'événement pour ModifyDBParameterGroup ou ModifyDBClusterParameterGroup au cours des 90 derniers jours.

Pour créer une copie du groupe de paramètres à l'aide de la console Amazon RDS

  1. Ouvrez la console Amazon RDS, puis choisissez Groupes de paramètres dans le volet de navigation.
  2. Sélectionnez le groupe de paramètres incompatible, puis choisissez Actions du groupe de paramètres.
  3. Choisissez Copier.

Pour réinitialiser tous les paramètres du groupe de paramètres aux valeurs par défaut à l'aide de la console Amazon RDS

  1. Ouvrez la console Amazon RDS, puis choisissez Groupes de paramètres dans le volet de navigation.
  2. Choisissez le groupe de paramètres que vous souhaitez réinitialiser.
  3. Choisissez Actions de groupe de paramètres, puis Réinitialiser.
  4. Choisissez Réinitialiser.

Pour réinitialiser les valeurs des paramètres à l'aide de la console Amazon RDS

Pour éviter de réinitialiser toutes les valeurs de paramètre du groupe de paramètres incompatibles, vous pouvez choisir les paramètres à modifier. Vous pouvez le faire en éditant le groupe de paramètres incompatibles depuis la console Amazon RDS.

  1. Ouvrez la console Amazon RDS, puis choisissez Groupes de paramètres dans le volet de navigation.
  2. Sélectionnez les groupes de paramètres incompatibles (ou pour réinitialiser tous les paramètres, sélectionnez tous les paramètres).
  3. Choisissez Parameter group actions (Actions du groupe de paramètres), puis Edit (Modifier).
  4. Entrez les valeurs de paramètres valides, puis choisissez Save Changes (Enregistrer les modifications).
  5. Redémarrez l'instance de base de données sans basculement pour appliquer de nouveaux paramètres.
    Remarque : la console Amazon RDS vous permet de modifier les paramètres en fonction des valeurs autorisées. L'interface de ligne de commande AWS (AWS CLI) vous permet de réinitialiser les paramètres cibles à leurs valeurs par défaut. Les modifications apportées aux valeurs des paramètres à l'aide de l'indicateur AWS CLI à une valeur autre que la valeur par défaut du paramètre n'ont aucun effet.

Pour plus d'informations sur les paramètres Oracle incompatibles avec Amazon RDS, consultez les sections Oracle 12c avec Amazon RDS et Utilisation d’énormes pages avec une instance Oracle DB.