Utilisation des groupes de paramètres DB - Amazon Relational Database Service

Utilisation des groupes de paramètres DB

Les instances de base de données utilisent des groupes de paramètres de base de données. Les sections suivantes décrivent la configuration et la gestion des groupes de paramètres d'une instance de base 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 à la AWS Management Console et ouvrez la console Amazon RDS à l'adresse https://console.aws.amazon.com/rds/.

  2. Dans le panneau 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 un .

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 8.0 avec la description « 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 MySQL8.0 \ --description "My new parameter group"

Pour Windows :

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

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

DBPARAMETERGROUP mydbparametergroup mysql8.0 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, consultez Création d'une instance de base de données Amazon RDS. Pour savoir comment modifier une instance de base de données, consultez Modification d'une instance de base de données Amazon RDS.

Note

Lorsque vous associez un nouveau groupe de paramètres de base de données à une instance de base de données, les paramètres statiques et dynamiques modifiés sont appliqués uniquement après que l'instance de base de données est redémarrée. Toutefois, si vous modifiez des paramètres dynamiques dans le groupe de paramètres de base de données nouvellement associé, ces modifications sont appliquées immédiatement sans redémarrage.

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

  1. Connectez-vous à la 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 (Modifier). 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 d'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 à la 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. Choisissez Enregistrer les modifications.

Pour modifier un groupe de paramètres de base de données, utilisez la commande modify-db-parameter-group de l'AWS CLI 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 à la 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 à la 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 copy-db-parameter-group de l'AWS CLI 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 à la 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.mysql8.0 mysql8.0 Default parameter group for MySQL8.0 DBPARAMETERGROUP mydbparametergroup mysql8.0 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 mysql8.0 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 à la 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