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

Dernière mise à jour : 02/09/2022

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

Une instance DB Amazon RDS dont l'état est incompatible-parameters signifie qu'au moins 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 DB.

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 avoir l'état available (Disponible). 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

Amazon RDS n'identifie pas et ne fournit pas directement le paramètre incompatible dans le groupe de paramètres attaché à Amazon RDS qui est à l'origine de l'état de paramètre incompatible. Cet état est un état Terminal qui vous oblige à corriger les paramètres incompatibles. 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 première du problème, copiez le groupe de paramètres incompatible, puis comparez les différences entre les valeurs des paramètres personnalisés et les valeurs par défaut. Par exemple, max_connections est une valeur par défaut du système. Si vous comparez un groupe de paramètres personnalisé dont une valeur personnalisée est définie pour le paramètre max_connections à un groupe de paramètres par défaut, vous voyez la valeur par défaut et la valeur personnalisée de ce paramètre afin de comparer la différence.

Remarque : lorsque vous comparez un groupe de paramètres personnalisé avec un groupe de paramètres par défaut, seules les valeurs par défaut des paramètres système par défaut apparaissent dans le groupe Paramètres par défaut. Les valeurs par défaut des paramètres par défaut du moteur ne sont pas affichées, car les valeurs des paramètres par défaut du moteur sont spécifiques à la version du moteur et aux paramètres de configuration de votre RDS.

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. Pour ce faire, modifiez le groupe de paramètres incompatible à partir de la console Amazon RDS.

  1. Ouvrez la console Amazon RDS, puis sélectionnezParameter groups (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 DB 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. Le remplacement des valeurs des paramètres à l'aide de l'AWS CLI par une valeur autre que la valeur par défaut du paramètre n'a aucun effet.

Pour plus d'informations sur les paramètres Oracle qui sont incompatibles avec Amazon RDS, consultez Administration de votre instance de base de données Oracle et Utilisation d'HugePages pour une instance de base de données Oracle.