Utilisation des groupes de paramètres de clusters de base de données pour les clusters de base de données Multi-AZ - Amazon Relational Database Service

Utilisation des groupes de paramètres de clusters de base de données pour les clusters de base de données Multi-AZ

Les clusters de base de données Multi-AZ utilisent des groupes de paramètres de cluster de base de données. Les sections suivantes décrivent la configuration et la gestion des groupes de paramètres de cluster de bases de données.

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

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

Après avoir créé un groupe de paramètres de base de données, attendez au moins cinq minutes avant de créer un cluster de base de données qui utilise ce groupe de paramètres de base de données. Cela permet à Amazon RDS de créer entièrement le groupe de paramètres avant qu'il ne soit utilisé par le nouveau cluster de base de données. Vous pouvez utiliser la page Parameter groups (Groupe de paramètres) de la console Amazon RDS ou la commande describe-db-cluster-parameters pour vérifier que votre groupe de paramètres de cluster de base de données a été créé.

Pour créer un groupe de paramètres de cluster 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 cluster de base de données.

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

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

  8. Sélectionnez Créer un .

Pour créer un groupe de paramètres de cluster de base de données, utilisez la commande d'AWS CLI create-db-cluster-parameter-group.

L'exemple suivant crée un groupe de paramètres de cluster de base de données nommé mydbclusterparametergroup pour MySQL version 8.0 avec une description de « My new cluster parameter group » (Mon nouveau groupe de paramètres de cluster).

Incluez les paramètres requis suivants :

  • --db-cluster-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-cluster-parameter-group \ --db-cluster-parameter-group-name mydbclusterparametergroup \ --db-parameter-group-family mysql8.0 \ --description "My new cluster parameter group"

Pour Windows :

aws rds create-db-cluster-parameter-group ^ --db-cluster-parameter-group-name mydbclusterparametergroup ^ --db-parameter-group-family mysql8.0 ^ --description "My new cluster parameter group"

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

{ "DBClusterParameterGroup": { "DBClusterParameterGroupName": "mydbclusterparametergroup", "DBParameterGroupFamily": "mysql8.0", "Description": "My new cluster parameter group", "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup2" } }

Pour créer un groupe de paramètres de cluster de base de données, utilisez l'action d'API RDS CreateDBClusterParameterGroup.

Incluez les paramètres requis suivants :

  • DBClusterParameterGroupName

  • DBParameterGroupFamily

  • Description

Modification de paramètres dans un groupe de paramètres de cluster de base de données

Vous pouvez modifier les valeurs des paramètres dans un groupe de paramètres de cluster base de données créé par le client. Vous ne pouvez pas modifier les valeurs des paramètres dans un groupe de paramètres de cluster de base de données par défaut. Les modifications apportées à des paramètres dans un groupe de paramètres de cluster de base de données créé par le client sont appliquées à tous les clusters de base de données qui sont associés au groupe de paramètres de cluster de base de données.

Pour modifier un groupe de paramètres de cluster 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 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.

  7. Redémarrez l'instance de base de données principale dans le cluster pour appliquer les modifications à toutes les instances de base de données du cluster.

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

  • --db-cluster-parameter-group-name

  • --parameters

L'exemple suivant modifie les valeurs server_audit_logging et server_audit_logs_upload dans le groupe de paramètres de cluster de base de données nommé mydbclusterparametergroup.

Exemple

Pour Linux, macOS ou Unix :

aws rds modify-db-cluster-parameter-group \ --db-cluster-parameter-group-name mydbclusterparametergroup \ --parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" \ "ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"

Pour Windows :

aws rds modify-db-cluster-parameter-group ^ --db-cluster-parameter-group-name mydbclusterparametergroup ^ --parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" ^ "ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"

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

DBCLUSTERPARAMETERGROUP mydbclusterparametergroup

Pour modifier un groupe de paramètres de cluster de base de données, utilisez la commande d'API RDS ModifyDBClusterParameterGroup avec les paramètres requis suivants :

  • DBClusterParameterGroupName

  • Parameters

Réinitialisation des paramètres dans un groupe de paramètres de cluster de bases de données

Vous pouvez réinitialiser les paramètres à leurs valeurs par défaut dans un groupe de paramètres de cluster de bases de données créé par le client. Les modifications apportées à des paramètres dans un groupe de paramètres de cluster de base de données créé par le client sont appliquées à tous les clusters de base de données qui sont associés au groupe de paramètres de cluster de base de données.

Note

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

Pour réinitialiser les paramètres d'un groupe de paramètres de cluster de bases de données à leurs valeurs par défaut

  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.

  7. Redémarrez l'instance de base de données principale dans le cluster pour appliquer les modifications à toutes les instances de base de données du cluster.

Pour réinitialiser les paramètres d'un groupe de paramètres de cluster DB à leurs valeurs par défaut, utilisez la commande reset-db-cluster-parameter-group de l'AWS CLI avec l'option requise suivante : --db-cluster-parameter-group-name.

Pour réinitialiser tous les paramètres du groupe de paramètres du cluster de bases 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-cluster-parameter-group \ --db-cluster-parameter-group-name mydbparametergroup \ --reset-all-parameters

Pour Windows :

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

L'exemple suivant modifie les valeurs server_audit_logging et server_audit_logs_upload dans le groupe de paramètres de cluster de bases de données nommé mydbclusterparametergroup.

Exemple

Pour Linux, macOS ou Unix :

aws rds reset-db-cluster-parameter-group \ --db-cluster-parameter-group-name mydbclusterparametergroup \ --parameters "ParameterName=server_audit_logging,ApplyMethod=immediate" \ "ParameterName=server_audit_logs_upload,ApplyMethod=immediate"

Pour Windows :

aws rds reset-db-cluster-parameter-group ^ --db-cluster-parameter-group-name mydbclusterparametergroup ^ --parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" ^ "ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"

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

DBClusterParameterGroupName mydbclusterparametergroup

Pour réinitialiser les paramètres d'un groupe de paramètres de cluster de bases de données à leurs valeurs par défaut, utilisez la commande ResetDBClusterParameterGroup de l'API RDS avec le paramètre obligatoire suivant : DBClusterParameterGroupName.

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

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

Vous pouvez copier des groupes de paramètres de cluster de base de données 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 de cluster de base de données 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 de cluster de base de données. Vous pouvez copier un groupe de paramètres de cluster de base de données en utilisant la commande copy-db-cluster-parameter-group de l'AWS CLI ou l'opération d'API RDS CopyDBClusterParameterGroup.

Après avoir copié un groupe de paramètres de base de données, attendez au moins cinq minutes avant de créer un cluster de base de données qui utilise ce groupe de paramètres de base de données. Cela permet à Amazon RDS de copier entièrement le groupe de paramètres avant qu'il ne soit utilisé par le nouveau cluster de base de données. Vous pouvez utiliser la page Parameter groups (Groupe de paramètres) de la console Amazon RDS ou la commande describe-db-cluster-parameters pour vérifier que votre groupe de paramètres de cluster 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.

Pour copier un groupe de paramètres de cluster de bases 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, 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 cluster de base de données, utilisez la commande copy-db-cluster-parameter-group de l'AWS CLI avec les paramètres requis suivants :

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

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

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

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

Exemple

Pour Linux, macOS ou Unix :

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

Pour Windows :

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

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

  • SourceDBClusterParameterGroupIdentifier

  • TargetDBClusterParameterGroupIdentifier

  • TargetDBClusterParameterGroupDescription

Affichage des groupes de paramètres de cluster de bases de données

Vous pouvez répertorier les groupes de paramètres de cluster de bases de données que vous avez créés 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 un cluster 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 de cluster de bases de données 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 de cluster de bases de données apparaissent dans la liste avec Groupe de paramètres de cluster de base de données pour le Type.

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

Exemple

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

aws rds describe-db-cluster-parameter-groups

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

Pour Linux, macOS ou Unix :

aws rds describe-db-cluster-parameter-groups \ --db-cluster-parameter-group-name mydbclusterparametergroup

Pour Windows :

aws rds describe-db-cluster-parameter-groups ^ --db-cluster-parameter-group-name mydbclusterparametergroup

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

{ "DBClusterParameterGroups": [ { "DBClusterParameterGroupName": "mydbclusterparametergroup2", "DBParameterGroupFamily": "mysql8.0", "Description": "My new cluster parameter group", "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup" } ] }

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

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

Vous pouvez obtenir une liste de tous les paramètres dans un groupe de paramètres de cluster de bases de données et de leurs valeurs.

Pour afficher les valeurs de paramètres pour un groupe de paramètres de cluster de bases 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.

    Les groupes de paramètres de cluster de bases de données apparaissent dans la liste avec Groupe de paramètres de cluster de base de données pour le Type.

  3. Choisissez le nom du groupe de paramètres du cluster de base de données pour afficher la liste des paramètres associée.

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

  • --db-cluster-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 cluster de bases de données nommé mydbclusterparametergroup au format JSON.

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

aws rds describe-db-cluster-parameters --db-cluster-parameter-group-name mydbclusterparametergroup
{ "Parameters": [ { "ParameterName": "activate_all_roles_on_login", "ParameterValue": "0", "Description": "Automatically set all granted roles as active after the user has authenticated successfully.", "Source": "engine-default", "ApplyType": "dynamic", "DataType": "boolean", "AllowedValues": "0,1", "IsModifiable": true, "ApplyMethod": "pending-reboot", "SupportedEngineModes": [ "provisioned" ] }, { "ParameterName": "allow-suspicious-udfs", "Description": "Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded", "Source": "engine-default", "ApplyType": "static", "DataType": "boolean", "AllowedValues": "0,1", "IsModifiable": false, "ApplyMethod": "pending-reboot", "SupportedEngineModes": [ "provisioned" ] }, ...

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

  • DBClusterParameterGroupName