Utilisation de groupes de paramètres de base de données - Amazon Relational Database Service

Utilisation de groupes de paramètres de base de données

Les paramètres de base de données spécifient comment la base de données est configurée. Par exemple, les paramètres de base de données peuvent spécifier la quantité de ressources, telles que la mémoire, à allouer à une base de données.

Vous gérez la configuration de votre base de données en associant vos instances de base de données à des groupes de paramètres. Amazon RDS définit des groupes de paramètres avec des paramètres par défaut.

Important

Vous pouvez définir vos propres groupes de paramètres à l'aide de paramètres personnalisés. Vous pouvez ensuite modifier vos instances de bases de données afin d'utiliser vos propres groupes de paramètres.

Pour plus d'informations sur la modification d'une instance de base de données , consultez Modification d'une instance de base de données Amazon RDS.

Note

Certains moteurs de base de données offrent des fonctions supplémentaires que vous pouvez ajouter à votre base de données en tant qu'options dans un groupe d'options. Pour plus d'informations sur les groupes d'options, consultez Utilisation de groupes d'options.

Un groupe de paramètres de base de données sert de conteneur pour les valeurs de configuration du moteur qui sont appliquées à une ou plusieurs instances de base de données.

Si vous créez une instance de base de données sans spécifier de groupe de paramètres de base de données, l'instance de base de données utilise un groupe de paramètres de base de données par défaut. Chaque groupe de paramètres de base de données par défaut contient des valeurs par défaut du moteur de base de données, ainsi que celles du système Amazon RDS en fonction du moteur, de la classe de calcul et de l'espace de stockage alloué de l'instance. Vous ne pouvez pas modifier les valeurs de paramètre d'un groupe de paramètres de base de données par défaut. Vous pouvez par contre créer votre propre groupe de paramètres et choisir les valeurs de chaque paramètre. Il n'est pas possible de modifier tous les paramètres de moteur de base de données dans un groupe de paramètres créé.

Si vous souhaitez utiliser votre propre groupe de paramètres, vous devez créer un nouveau groupe de paramètres et modifier les paramètres en fonction de vos souhaits. Vous modifiez ensuite votre instance de base de données afin d'utiliser le nouveau groupe de paramètres. Si vous mettez à jour les paramètres d'un groupe de paramètres de base de données, les modifications effectuées s'appliquent à toutes les instances de base de données qui sont associées à ce groupe de paramètres.

Vous pouvez également copier un groupe de paramètres de base de données existant avec la commande copy-db-parameter-group de l'AWS CLI. La copie d'un groupe de paramètres peut être utile lorsque vous souhaitez inclure la plupart des paramètres et valeurs personnalisés d'un groupe de paramètres de base de données existant dans un nouveau groupe de paramètres de base de données.

Voici quelques éléments importants concernant l'utilisation de paramètres dans un groupe de paramètres de base de données :

  • Les paramètres de base de données sont statiques ou dynamiques. Lorsque vous modifiez un paramètre statique, un redémarrage de la base de données est nécessaire pour que les changements entrent en vigueur. Lorsque vous modifiez un paramètre dynamique et que vous enregistrez le groupe de paramètres de base de données, la modification est appliquée immédiatement, quel que soit le paramètre Appliquer immédiatement. Lorsque vous modifiez un paramètre statique et que vous enregistrez le groupe de paramètres de base de données, la modification du paramètre est appliquée une fois que vous avez redémarré manuellement l'instance de base de données. Vous pouvez redémarrer une instance de base de données à l'aide de la console RDS, en appelant la commande de CLI reboot-db-instance ou en appelant l'opération API RebootDbInstance. Les critères pour redémarrer l'instance de base de données associée après un changement de paramètre statique contribuent à atténuer le risque d'erreur de configuration d'un paramètre affectant un appel d'API, comme appeler ModifyDBInstance pour modifier la classe d'instance de base de données ou le stockage évolutif.

    Si une instance de base de données n'utilise pas les dernières modifications apportées à son groupe de paramètres de base de données associé, AWS Management Console affiche le groupe de paramètres de base de données avec le statut suivant : pending-reboot. Le statut de groupe de paramètres pending-reboot n'entraîne pas de redémarrage automatique lors de la fenêtre de maintenance suivante. Pour appliquer les modifications de paramètre les plus récentes apportées à cette instance de base de données, vous devez la redémarrer manuellement.

  • Lorsque vous modifiez le groupe de paramètres de base de données associé à une instance de base de données, vous devez redémarrer manuellement l'instance avant que le nouveau groupe de paramètres de base de données puisse être utilisé par l'instance de base de données. Pour plus d'informations sur la modification du groupe de paramètres de base de données, veuillez consulter Modification d'une instance de base de données Amazon RDS.

  • Vous pouvez spécifier la valeur d'un paramètre de base de données sous la forme d'un entier ou d'une expression d'entiers créée à partir de formules, de variables, de fonctions et d'opérateurs. Les fonctions peuvent inclure une expression de journal mathématique. Pour plus d'informations, consultez Spécification des paramètres de base de données.

  • Définissez les paramètres qui concernent le jeu de caractères ou le classement de votre base de données dans votre groupe de paramètres avant de créer l'instance de base de données et avant de créer une base de données dans votre instance de base de données. Cela garantit que la base de données par défaut et les nouvelles bases de données dans votre instance de base de données utilisent les valeurs de jeu de caractères et de classement que vous spécifiez. Si vous modifiez les paramètres de jeu de caractères ou de classement pour votre instance de base de données, les modifications de paramètre ne sont pas appliquées aux bases de données existantes.

    Vous pouvez modifier les valeurs de jeu de caractères ou de classement pour une base de données existante à l'aide de la commande ALTER DATABASE, par exemple :

    ALTER DATABASE database_name CHARACTER SET character_set_name COLLATE collation;
  • La configuration incorrecte de paramètres dans un groupe de paramètres DB peut avoir des effets contraires involontaires, dont une dégradation de la performance et une instabilité du système. Montrez-vous toujours prudent lorsque vous modifiez des paramètres de base de données et sauvegardez vos données avant de modifier un groupe de paramètres de base de données. Testez les modifications des valeurs d'un groupe de paramètres sur une instance de base de données de test avant d'appliquer ces modifications à une instance de base de données de production.

  • Pour déterminer les paramètres pris en charge par votre moteur de base de données, vous pouvez afficher les paramètres dans le groupe de paramètres de base de données utilisé par l'instance de base de données. Pour plus d'informations, consultez Affichage des valeurs de paramètres pour un groupe de paramètres de bases de données.

Création d'un groupe de paramètres de bases de données

Vous pouvez créer un groupe de paramètres de base de données à l'aide de la AWS Management Console, de l'AWS CLI ou de l'API RDS.

Pour créer un groupe de paramètres de base de données

  1. Connectez-vous à l'AWS Management Console et ouvrez la console Amazon RDS à l'adresse https://console.aws.amazon.com/rds/.

  2. Dans le volet de navigation, choisissez Groupes de paramètres.

  3. Choisissez Créer un groupe de paramètres.

    La fenêtre Créer un groupe de paramètres s'affiche.

  4. Dans la liste Famille de groupe de paramètres, sélectionnez une famille de groupe de paramètres de base de données.

  5. Dans la liste Type, sélectionnez Groupe de paramètres de base de données.

  6. Dans la zone Nom du groupe, entrez le nom du nouveau groupe de paramètres de base de données.

  7. Dans la zone Description, entrez une description pour le nouveau groupe de paramètres de base de données.

  8. Sélectionnez Créer.

Pour créer un groupe de paramètres de base de données, utilisez la commande AWS CLI de l'create-db-parameter-group. L'exemple suivant crée un groupe de paramètres de base de données nommé mydbparametergroup pour MySQL version 5.6 avec une description de « My new parameter group (Mon nouveau groupe de paramètres) ».

Incluez les paramètres requis suivants :

  • --db-parameter-group-name

  • --db-parameter-group-family

  • --description

Pour répertorier toutes les familles de groupes de paramètres, utilisez la commande suivante :

aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily"
Note

La sortie contient des doublons.

Exemple

Pour Linux, macOS ou Unix :

aws rds create-db-parameter-group \ --db-parameter-group-name mydbparametergroup \ --db-parameter-group-family MySQL5.6 \ --description "My new parameter group"

Pour Windows :

aws rds create-db-parameter-group ^ --db-parameter-group-name mydbparametergroup ^ --db-parameter-group-family MySQL5.6 ^ --description "My new parameter group"

Le résultat produit lors de l'exécution de cette commande est semblable à ce qui suit :

DBPARAMETERGROUP mydbparametergroup mysql5.6 My new parameter group

Pour créer un groupe de paramètres de base de données, utilisez l'opération d'API RDS CreateDBParameterGroup.

Incluez les paramètres requis suivants :

  • DBParameterGroupName

  • DBParameterGroupFamily

  • Description

Association d'un groupe de paramètres de base de données à une instance de base de données

Vous pouvez créer vos propres groupes de paramètres de base de données avec des paramètres personnalisés. Vous pouvez associer un groupe de paramètres de base de données à une instance de base de données à l'aide de AWS Management Console, de AWS CLI ou de l'API RDS. Vous pouvez le faire lorsque vous créez ou modifiez une instance de base de données.

Pour plus d'informations sur la création d'un groupe de paramètres de base de données, consultez Création d'un groupe de paramètres de bases de données. Pour plus d'informations sur la création d'une instance de base de données, veuillez consulter Création d'une instance de base de données Amazon RDS. Pour plus d'informations sur la modification d'une instance de base de données , consultez Modification d'une instance de base de données Amazon RDS.

Note

Lorsque vous modifiez le groupe de paramètres de base de données associé à une instance de base de données, vous devez redémarrer manuellement l'instance avant que le nouveau groupe de paramètres de base de données puisse être utilisé par l'instance de base de données.

Associer un groupe de paramètres de base de données à une instance de base de données

  1. Connectez-vous à l'AWS Management Console et ouvrez la console Amazon RDS à l'adresse https://console.aws.amazon.com/rds/.

  2. Dans le panneau de navigation, choisissez Bases de données, puis l'instance de base de données que vous souhaitez modifier.

  3. Sélectionnez Modify. La page Modifier l'instance de base de données s'affiche.

  4. Modifiez le paramètre DB parameter group (groupe de paramètres de base de données).

  5. Choisissez Continuer et vérifiez le récapitulatif des modifications.

  6. (Facultatif) Choisissez Appliquer immédiatement pour appliquer les modifications immédiatement. La sélection de cette option peut entraîner une interruption de service dans certains cas. Pour plus d'informations, consultez Utilisation du paramètre Appliquer immédiatement.

  7. Sur la page de confirmation, examinez vos modifications. Si elles sont correctes, choisissez Modify DB instance (Modifier l'instance de base de données) pour enregistrer vos modifications.

    Ou choisissez Retour pour revoir vos modifications, ou choisissez Annuler pour les annuler.

Pour associer un groupe de paramètres de base de données à une instance de base de données, utilisez la commande AWS CLI modify-db-instance avec les options suivantes :

  • --db-instance-identifier

  • --db-parameter-group-name

L'exemple suivant associe le groupe de paramètres de base de données mydbpg à l'instance de base de données database-1. Les modifications sont appliquées immédiatement en utilisant --apply-immediately. Utilisez --no-apply-immediately pour appliquer les modifications pendant le créneau de maintenance suivant. Pour plus d'informations, consultez Utilisation du paramètre Appliquer immédiatement.

Exemple

Pour Linux, macOS ou Unix :

aws rds modify-db-instance \ --db-instance-identifier database-1 \ --db-parameter-group-name mydbpg \ --apply-immediately

Pour Windows :

aws rds modify-db-instance ^ --db-instance-identifier database-1 ^ --db-parameter-group-name mydbpg ^ --apply-immediately

Pour associer un groupe de paramètres de base de données à une instance de base de données, utilisez l'opération d'API RDS ModifyDBInstance avec les paramètres suivants :

  • DBInstanceName

  • DBParameterGroupName

Modification de paramètres dans un groupe de paramètres de bases de données

Vous pouvez modifier des valeurs de paramètres dans un groupe de paramètres de base de données créé par le client. Par contre, vous ne pouvez pas modifier les valeurs de paramètres dans un groupe de paramètres de base de données par défaut. Les modifications apportées à des paramètres dans un groupe de paramètres DB créé par le client sont appliquées à toutes les instances de base de données qui sont associées au groupe de paramètres DB.

Les modifications apportées à certains paramètres sont appliquées immédiatement à l'instance de base de données sans redémarrage. Les modifications apportées à d'autres paramètres s'appliquent uniquement après le redémarrage de l'instance de base de données. La console RDS affiche le statut du groupe de paramètres de base de données associé à une instance de base de données dans l'onglet Configuration. Par exemple, si l'instance de base de données n'utilise pas les dernières modifications apportées à son groupe de paramètres de base de données associé, la console RDS affiche le groupe de paramètres de base de données avec le statut suivant : pending-reboot. Pour appliquer les modifications de paramètre les plus récentes apportées à cette instance de base de données, vous devez la redémarrer manuellement.


				Scénario de redémarrage en attente de modification de paramètre

Pour modifier un groupe de paramètres DB

  1. Connectez-vous à l'AWS Management Console et ouvrez la console Amazon RDS à l'adresse https://console.aws.amazon.com/rds/.

  2. Dans le volet de navigation, choisissez Groupes de paramètres.

  3. Dans la liste, sélectionnez le groupe de paramètres que vous souhaitez modifier.

  4. Sous Parameter group actions (Actions de groupe de paramètres), choisissez Edit (Modifier).

  5. Modifiez les valeurs des paramètres que vous souhaitez remplacer. Vous pouvez parcourir les paramètres en utilisant les touches fléchées en haut à droite de la boîte de dialogue.

    Vous ne pouvez pas modifier les valeurs dans un groupe de paramètres par défaut.

  6. Sélectionnez Save Changes.

Pour modifier un groupe de paramètres de base de données, utilisez la commande AWS CLI de l'modify-db-parameter-group avec les options requises suivantes :

  • --db-parameter-group-name

  • --parameters

L'exemple suivant modifie les valeurs max_connections et max_allowed_packet dans le groupe de paramètres de base de données nommé mydbparametergroup.

Exemple

Pour Linux, macOS ou Unix :

aws rds modify-db-parameter-group \ --db-parameter-group-name mydbparametergroup \ --parameters "ParameterName=max_connections,ParameterValue=250,ApplyMethod=immediate" \ "ParameterName=max_allowed_packet,ParameterValue=1024,ApplyMethod=immediate"

Pour Windows :

aws rds modify-db-parameter-group ^ --db-parameter-group-name mydbparametergroup ^ --parameters "ParameterName=max_connections,ParameterValue=250,ApplyMethod=immediate" ^ "ParameterName=max_allowed_packet,ParameterValue=1024,ApplyMethod=immediate"

La commande produit un résultat similaire à ce qui suit :

DBPARAMETERGROUP mydbparametergroup

Pour modifier un groupe de paramètres de base de données, utilisez l'opération d'API RDS ModifyDBParameterGroup avec les paramètres requis suivants :

  • DBParameterGroupName

  • Parameters

Réinitialisation des valeurs par défaut des paramètres d'un groupe de paramètres de base de données

Vous pouvez rétablir les valeurs par défaut des paramètres d'un groupe de paramètres de base de données créé par le client. Les modifications apportées à des paramètres dans un groupe de paramètres DB créé par le client sont appliquées à toutes les instances de base de données qui sont associées au groupe de paramètres DB.

Lorsque vous utilisez la console, vous pouvez rétablir les valeurs par défaut de paramètres spécifiques, mais vous ne pouvez pas facilement réinitialiser tous les paramètres du groupe de paramètres de base de données simultanément. Lorsque vous utilisez AWS CLI ou l'API RDS, vous pouvez rétablir les valeurs par défaut de paramètres spécifiques, et vous pouvez réinitialiser tous les paramètres du groupe de paramètres de base de données simultanément.

Les modifications apportées à certains paramètres sont appliquées immédiatement à l'instance de base de données sans redémarrage. Les modifications apportées à d'autres paramètres s'appliquent uniquement après le redémarrage de l'instance de base de données. La console RDS affiche le statut du groupe de paramètres de base de données associé à une instance de base de données dans l'onglet Configuration. Par exemple, si l'instance de base de données n'utilise pas les dernières modifications apportées à son groupe de paramètres de base de données associé, la console RDS affiche le groupe de paramètres de base de données avec le statut suivant : pending-reboot. Pour appliquer les modifications de paramètre les plus récentes apportées à cette instance de base de données, vous devez la redémarrer manuellement.


				Scénario de redémarrage en attente de modification de paramètre
Note

Dans un groupe de paramètres de base de données par défaut, les paramètres sont toujours définis sur leurs valeurs par défaut.

Pour réinitialiser les valeurs par défaut des paramètres d'un groupe de paramètres de base de données

  1. Connectez-vous à l'AWS Management Console et ouvrez la console Amazon RDS à l'adresse https://console.aws.amazon.com/rds/.

  2. Dans le volet de navigation, choisissez Groupes de paramètres.

  3. Dans la liste, sélectionnez le groupe de paramètres.

  4. Sous Parameter group actions (Actions de groupe de paramètres), choisissez Edit (Modifier).

  5. Sélectionnez les paramètres que vous souhaitez réinitialiser à leurs valeurs par défaut. Vous pouvez parcourir les paramètres en utilisant les touches fléchées en haut à droite de la boîte de dialogue.

    Vous ne pouvez pas réinitialiser les valeurs dans un groupe de paramètres par défaut.

  6. Choisissez Réinitialiser, puis confirmez en sélectionnant Réinitialiser les paramètres.

Pour réinitialiser tout ou partie des paramètres d'un groupe de paramètres de base de données, utilisez la commande AWS CLI reset-db-parameter-group avec l'option obligatoire suivante : --db-parameter-group-name.

Pour réinitialiser tous les paramètres du groupe de paramètres de base de données, spécifiez l'option --reset-all-parameters. Pour réinitialiser des paramètres spécifiques, spécifiez l'option --parameters.

L'exemple suivant réinitialise tous les paramètres du groupe de paramètres de base de données nommé mydbparametergroup à leurs valeurs par défaut.

Exemple

Pour Linux, macOS ou Unix :

aws rds reset-db-parameter-group \ --db-parameter-group-name mydbparametergroup \ --reset-all-parameters

Pour Windows :

aws rds reset-db-parameter-group ^ --db-parameter-group-name mydbparametergroup ^ --reset-all-parameters

L'exemple suivant réinitialise les valeurs par défaut des options max_connections et max_allowed_packet du groupe de paramètres de base de données mydbparametergroup.

Exemple

Pour Linux, macOS ou Unix :

aws rds reset-db-parameter-group \ --db-parameter-group-name mydbparametergroup \ --parameters "ParameterName=max_connections,ApplyMethod=immediate" \ "ParameterName=max_allowed_packet,ApplyMethod=immediate"

Pour Windows :

aws rds reset-db-parameter-group ^ --db-parameter-group-name mydbparametergroup ^ --parameters "ParameterName=max_connections,ApplyMethod=immediate" ^ "ParameterName=max_allowed_packet,ApplyMethod=immediate"

La commande produit un résultat similaire à ce qui suit :

DBParameterGroupName mydbparametergroup

Pour réinitialiser les valeurs par défaut des paramètres d'un groupe de paramètres de base de données, utilisez la commande ResetDBParameterGroup de l'API RDS avec le paramètre obligatoire suivant : DBParameterGroupName.

Pour réinitialiser tous les paramètres du groupe de paramètres de base de données, définissez le ResetAllParameters paramètre sur true. Pour réinitialiser des paramètres spécifiques, spécifiez le paramètre Parameters.

Copie d'un groupe de paramètres de bases de données

Vous pouvez copier des groupes de paramètres DB personnalisés que vous créez. La copie d'un groupe de paramètres est une solution pratique lorsque vous avez déjà créé un groupe de paramètres DB et que vous souhaitez inclure la plupart des valeurs et des paramètres personnalisés de ce groupe dans un nouveau groupe de paramètres DB. Vous pouvez copier un groupe de paramètres de base de données en utilisant la AWS Management Console, la commande AWS CLI copy-db-parameter-group ou l'opération d'API RDS CopyDBParameterGroup.

Après avoir copié un groupe de paramètres de base de données, patientez au moins 5 minutes avant de créer votre première instance de base de données utilisant ce groupe comme groupe de paramètres par défaut. Cela permet à Amazon RDS de terminer complètement l'action de copie avant l'utilisation du groupe de paramètres. Cela est particulièrement important pour les paramètres qui sont essentiels lors de la création de la base de données par défaut d'une instance de base de données. Parmi ces paramètres, citons par exemple le jeu de caractères de la base de données par défaut défini par le paramètre character_set_database. Utilisez l'option Groupe de paramètres de la console Amazon RDS ou la commande describe-db-parameters pour vérifier que votre groupe de paramètres de base de données a été créé.

Note

Vous ne pouvez pas copier un groupe de paramètres par défaut. Toutefois, vous pouvez créer un nouveau groupe de paramètres basé sur un groupe de paramètres par défaut.

Actuellement, vous ne pouvez pas copier de groupe de paramètres dans une autre région AWS.

Pour copier un groupe de paramètres DB

  1. Connectez-vous à l'AWS Management Console et ouvrez la console Amazon RDS à l'adresse https://console.aws.amazon.com/rds/.

  2. Dans le volet de navigation, choisissez Groupes de paramètres.

  3. Dans la liste, choisissez le groupe de paramètres personnalisé que vous souhaitez copier.

  4. Sous Parameter group actions (Actions de groupe de paramètres), choisissez Copy (Copier).

  5. Dans New DB parameter group identifier (Nouvel identifiant de groupe de paramètres de base de données), saisissez un nom pour le nouveau groupe de paramètres.

  6. Dans Description, saisissez une description pour le nouveau groupe de paramètres.

  7. Choisissez Copy.

Pour copier un groupe de paramètres de base de données, utilisez la commande AWS CLI de l'copy-db-parameter-group avec les options requises suivantes :

  • --source-db-parameter-group-identifier

  • --target-db-parameter-group-identifier

  • --target-db-parameter-group-description

L'exemple suivant crée un groupe de paramètres DB nommé mygroup2 qui est une copie du groupe de paramètres DB mygroup1.

Exemple

Pour Linux, macOS ou Unix :

aws rds copy-db-parameter-group \ --source-db-parameter-group-identifier mygroup1 \ --target-db-parameter-group-identifier mygroup2 \ --target-db-parameter-group-description "DB parameter group 2"

Pour Windows :

aws rds copy-db-parameter-group ^ --source-db-parameter-group-identifier mygroup1 ^ --target-db-parameter-group-identifier mygroup2 ^ --target-db-parameter-group-description "DB parameter group 2"

Pour copier un groupe de paramètres de base de données, utilisez l'opération d'API RDS CopyDBParameterGroup avec les paramètres requis suivants :

  • SourceDBParameterGroupIdentifier

  • TargetDBParameterGroupIdentifier

  • TargetDBParameterGroupDescription

Liste des groupes de paramètres de bases de données

Vous pouvez répertorier les groupes de paramètres DB que vous avez créées pour votre compte AWS.

Note

Les groupes de paramètres par défaut sont automatiquement créés à partir d'un modèle de paramètre par défaut lorsque vous créez une instance de base de données pour une version et un moteur de base de données spécifiques. Ces groupes de paramètres par défaut contiennent des valeurs de paramètres préférentielles et ne peuvent pas être modifiés. Lorsque vous créez un groupe de paramètres personnalisé, vous pouvez modifier les réglages des paramètres.

Pour répertorier tous les groupes de paramètres DB pour un compte AWS

  1. Connectez-vous à l'AWS Management Console et ouvrez la console Amazon RDS à l'adresse https://console.aws.amazon.com/rds/.

  2. Dans le volet de navigation, choisissez Groupes de paramètres.

    Les groupes de paramètres DB s'affichent dans une liste.

Pour répertorier tous les groupes de paramètres de base de données pour un compte AWS, utilisez la commande AWS CLI de l'describe-db-parameter-groups.

Exemple

L'exemple suivant répertorie tous les groupes de paramètres DB disponibles pour un compte AWS.

aws rds describe-db-parameter-groups

La commande renvoie une réponse telle que la suivante :

DBPARAMETERGROUP default.mysql5.6 mysql5.6 Default parameter group for MySQL5.6 DBPARAMETERGROUP mydbparametergroup mysql5.6 My new parameter group

L'exemple suivant décrit le groupe de paramètres mydbparamgroup1.

Pour Linux, macOS ou Unix :

aws rds describe-db-parameter-groups \ --db-parameter-group-name mydbparamgroup1

Pour Windows :

aws rds describe-db-parameter-groups ^ --db-parameter-group-name mydbparamgroup1

La commande renvoie une réponse telle que la suivante :

DBPARAMETERGROUP mydbparametergroup1 mysql5.6 My new parameter group

Pour répertorier tous les groupes de paramètres de base de données pour un compte AWS, utilisez l'opération d'API RDS DescribeDBParameterGroups.

Affichage des valeurs de paramètres pour un groupe de paramètres de bases de données

Vous pouvez obtenir une liste de tous les paramètres dans un groupe de paramètres DB et de leurs valeurs.

Pour afficher les valeurs de paramètres pour un groupe de paramètres DB

  1. Connectez-vous à l'AWS Management Console et ouvrez la console Amazon RDS à l'adresse https://console.aws.amazon.com/rds/.

  2. Dans le volet de navigation, choisissez Groupes de paramètres.

    Les groupes de paramètres DB s'affichent dans une liste.

  3. Choisissez le nom du groupe de paramètres pour consulter la liste des paramètres associée.

Pour afficher les valeurs de paramètre d'un groupe de paramètres de base de données, utilisez la commande AWS CLI de l'describe-db-parameters avec le paramètre requis suivant.

  • --db-parameter-group-name

Exemple

L'exemple suivant répertorie les paramètres et les valeurs de paramètres pour un groupe de paramètres de base de données nommé mydbparametergroup.

aws rds describe-db-parameters --db-parameter-group-name mydbparametergroup

La commande renvoie une réponse telle que la suivante :

DBPARAMETER Parameter Name Parameter Value Source Data Type Apply Type Is Modifiable DBPARAMETER allow-suspicious-udfs engine-default boolean static false DBPARAMETER auto_increment_increment engine-default integer dynamic true DBPARAMETER auto_increment_offset engine-default integer dynamic true DBPARAMETER binlog_cache_size 32768 system integer dynamic true DBPARAMETER socket /tmp/mysql.sock system string static false

Pour afficher les valeurs de paramètre d'un groupe de paramètres de base de données, utilisez la commande d'API RDS DescribeDBParameters avec le paramètre requis suivant :

  • DBParameterGroupName

Comparaison des groupes de paramètres de bases de données

Vous pouvez utiliser l'AWS Management Console afin d'examiner les différences entre les groupes de paramètres pour le même moteur et la même version de base de données.

Pour comparer deux groupes de paramètres de bases de données

  1. Connectez-vous à l'AWS Management Console et ouvrez la console Amazon RDS à l'adresse https://console.aws.amazon.com/rds/.

  2. Dans le volet de navigation, choisissez Groupes de paramètres.

  3. Dans la liste, choisissez les deux groupes de paramètres que vous souhaitez comparer.

  4. Sous Parameter group actions (Actions de groupe de paramètres), choisissez Compare (Comparer).

    Note

    Si les éléments que vous avez sélectionnés ne sont pas équivalents, vous ne pouvez pas choisir Compare (Comparer). Par exemple, vous ne pouvez pas comparer un groupe de paramètres MySQL 5.6 et MySQL 5.7. Vous ne pouvez pas comparer un groupe de paramètres de base de données et un groupe de paramètres de cluster de bases de données Aurora.

Spécification des paramètres de base de données

Les types de paramètres de base de données sont les suivants :

  • Integer

  • Booléen

  • String

  • Long

  • Double

  • Horodatage

  • Objet d'autres types de données définis

  • Tableau de valeurs de type entier, booléen, chaîne, long, double, horodatage ou objet

Vous pouvez également spécifier des paramètres de base de données entiers et booléens au moyen d'expressions, de formules et de fonctions.

Pour le moteur Oracle, vous pouvez utiliser la variable de formule DBInstanceClassHugePagesDefault pour spécifier un paramètre de base de données booléen. Voir Variables de formule de paramètre de bases de données.

Pour le moteur PostgreSQL, vous pouvez utiliser une expression pour spécifier un paramètre de base de données booléen. Voir Expressions de paramètre de base de données booléennes.

Des formules de paramètre de bases de données

Une formule de paramètre de base de données est une expression qui se réduit à une valeur entière ou booléenne. Vous insérez l'expression entre des accolades : {}. Vous pouvez utiliser une formule pour une valeur de paramètre de base de données ou en tant qu'argument pour une fonction de paramètre de base de données.

Syntaxe
{FormulaVariable} {FormulaVariable*Integer} {FormulaVariable*Integer/Integer} {FormulaVariable/Integer}

Variables de formule de paramètre de bases de données

Chaque variable de formule renvoie une valeur entière ou booléenne. Les noms des variables sont sensibles à la casse.

AllocatedStorage

Renvoie un entier qui représente la taille du volume de données en octets.

DBInstanceClassHugePagesDefault

Renvoie une valeur booléenne. Actuellement, la prise en charge ne concerne que les moteurs Oracle.

Pour plus d'informations, consultez Activation de HugePages pour une instance de base de données Oracle.

DBInstanceClassMemory

Renvoie un entier du nombre d'octets de mémoire alloués à la classe d'instance de base de données associée à l'instance de base de données actuelle, moins la mémoire utilisée par les processus RDS qui gèrent l'instance.

DBInstanceVCPU

Renvoie un entier qui représente le nombre d'unités de traitement centralisées virtuelles (vCPU) utilisées par Amazon RDS pour gérer l'instance. Actuellement, la prise en charge ne concerne que le moteur PostgreSQL.

EndPointPort

Renvoie un entier qui représente le port utilisé lors de la connexion à l'instance de base de données.

Opérateurs de formule de paramètre de bases de données

Les formules de paramètre DB prennent en charge deux opérateurs : division et multiplication.

Opérateur de division : /

Divise le dividende par le diviseur, en renvoyant un quotient entier. Les décimales dans le quotient sont tronquées, pas arrondies.

Syntaxe

dividend / divisor

Les arguments de dividende et de diviseur doivent être des expressions entières.

Opérateur de multiplication : *

Multiplie les expressions, affichant ainsi le résultat des expressions. Les décimales dans les expressions sont tronquées, pas arrondies.

Syntaxe

expression * expression

Les deux expressions doivent être des entiers.

Fonctions de paramètre de bases de données

Vous spécifiez les arguments des fonctions de paramètres de base de données sous la forme d'entiers ou de formules. Chaque fonction doit avoir au moins un argument. Spécifiez plusieurs arguments sous la forme d'une liste séparée par des virgules. Cette liste ne peut pas contenir de membres vides, tels que argument1,,argument3. Les noms de fonctions ne sont pas sensibles à la casse.

IF

Renvoie un argument.

Actuellement, la prise en charge ne concerne que les moteurs Oracle et est le seul premier argument pris en charg {DBInstanceClassHugePagesDefault}. Pour plus d'informations, consultez Activation de HugePages pour une instance de base de données Oracle.

Syntaxe

IF(argument1, argument2, argument3)

Renvoie le deuxième argument si le premier a la valeur true. Sinon, renvoie le troisième argument.

GREATEST

Renvoie la plus grande valeur depuis une liste d'entiers ou de formules de paramètres.

Syntaxe

GREATEST(argument1, argument2,...argumentn)

Renvoie un entier.

LEAST

Renvoie la plus petite valeur depuis une liste d'entiers ou de formules de paramètres.

Syntaxe

LEAST(argument1, argument2,...argumentn)

Renvoie un entier.

SUM

Ajoute les valeurs des formules de paramètres ou d'entiers spécifiés.

Syntaxe

SUM(argument1, argument2,...argumentn)

Renvoie un entier.

Expressions de paramètre de base de données booléennes

Une expression de paramètre de base de données booléenne se réduit à une valeur booléenne de 1 ou 0. L'expression est insérée entre guillemets.

Note

Les expressions de paramètres de base de données booléennes ne sont prises en charge que pour le moteur PostgreSQL.

Syntaxe
"expression operator expression"

Les deux expressions doivent se réduire à des entiers. Une expression peut être l'un des éléments suivants :

  • Une constante entière

  • Une formule de paramètre de base de données

  • Une fonction de paramètre de base de données

  • Une variable de paramètre de base de données

Les expressions de paramètres de base de données booléennes prennent en charge les opérateurs d'inégalité suivants :

L'opérateur supérieur à : >

Syntaxe

"expression > expression"
L'opérateur inférieur à : <

Syntaxe

"expression < expression"
Les opérateurs supérieur ou égal à : >=, =>

Syntaxe

"expression >= expression" "expression => expression"
Les opérateurs inférieur ou égal à : <=, =<

Syntaxe

"expression <= expression" "expression =< expression"

Exemple utilisation d'une expression de paramètre de base de données booléenne

L'exemple d'expression de paramètre de base de données booléenne suivant compare le résultat d'une formule de paramètre à un entier pour modifier le paramètre de base de données booléen wal_compression pour une instance de base de données PostgreSQL. L'expression de paramètre compare le nombre de vCPU à la valeur 2. Si le nombre de VCPU est supérieur à 2, le paramètre de base de données wal_compression est alors défini à la valeur true.

aws rds modify-db-parameter-group --db-parameter-group-name group-name \ --parameters "ParameterName=wal_compression,ParameterValue=\"{DBInstanceVCPU} > 2\" "

Expressions de journal des paramètres de base de données

Vous pouvez définir une valeur de paramètre de base de données entier à une expression de journal. Vous insérez l'expression entre des accolades : {}. Exemples :

{log(DBInstanceClassMemory/8187281418)*1000}

La fonction log représente la base du journal 2. Cet exemple utilise également la variable de formule DBInstanceClassMemory. Voir Variables de formule de paramètre de bases de données.

Note

Pour le moment, vous ne pouvez pas spécifier le paramètre innodb_log_file_size MySQL avec une autre valeur qu'un entier.

Exemples de valeurs de paramètre de bases de données

Ces exemples montrent l'utilisation de formules, de fonctions et d'expressions pour les valeurs des paramètres de base de données.

Note

Les fonctions des paramètres de base de données sont actuellement prises en charge uniquement dans la console, mais pas dans la CLI AWS.

Avertissement

La définition incorrecte des paramètres d'un groupe de paramètres de base de données peut avoir des effets indésirables involontaires. Cela peut se manifester par une dégradation des performances et l'instabilité du système. Agissez avec prudence lorsque vous modifiez des paramètres de base de données et sauvegardez vos données avant de modifier votre groupe de paramètres de base de données. Testez les modifications d'un groupe de paramètres sur une instance de base de données test, créée en utilisant des restaurations à un moment donné, avant d'appliquer ces modifications à vos instances de base de données de production.

Exemple utilisation de la fonction de paramètre de base de données GREATEST

Vous pouvez spécifier la fonction GREATEST dans un paramètre de processus Oracle. Utilisez-la pour définir le nombre de processus utilisateur sur le plus grand des deux nombres : 80 ou DBInstanceClassMemory divisé par 9 868 951.

GREATEST({DBInstanceClassMemory/9868951},80)

Exemple utilisation de la fonction de paramètre de base de données LEAST

Vous pouvez spécifier la fonction LEAST dans une valeur de paramètre MySQL max_binlog_cache_size. Utilisez-la pour définir la taille de cache maximale qu'une transaction peut utiliser dans une instance MySQL à la moins élevée des valeurs suivantes : 1 Mo ou DBInstanceClass/256.

LEAST({DBInstanceClassMemory/256},10485760)