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
Création d'un groupe de paramètres de cluster de base de donnéesModification de paramètres dans un groupe de paramètres de cluster de base de donnéesRéinitialisation des paramètres dans un groupe de paramètres de cluster de bases de donnéesCopie d'un groupe de paramètres de cluster de base de donnéesAffichage des groupes de paramètres de cluster de bases de donnéesAffichage des valeurs de paramètres pour un groupe de paramètres de cluster de bases de donnéesSuppression d'un groupe de paramètres de cluster de base de données

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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 nouveau groupe de paramètres de cluster de base de données à l'aide de l'API AWS Management Console, de 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 Groupes de paramètres de la console Amazon RDS ou la describe-db-cluster-parameterscommande pour vérifier que votre groupe de paramètres de cluster de base de données est créé.

Les limites suivantes s'appliquent aux noms de groupes de paramètres de cluster de bases de données :

  • Ces noms doivent comporter entre 1 et 255 lettres, chiffres ou traits d'union.

    Les noms des groupes de paramètres par défaut peuvent inclure un point, par exemple default.aurora-mysql5.7. Toutefois, les noms de groupes de paramètres personnalisés ne peuvent pas inclure de point.

  • Le premier caractère doit être une lettre.

  • Les noms ne peuvent pas se terminer par un trait d'union ni contenir deux traits d'union consécutifs.

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

  1. Connectez-vous à la console Amazon RDS AWS Management Console et ouvrez-la à 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 le groupe de paramètres du 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.

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

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 LinuxmacOS, 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"

Dans 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 console Amazon RDS AWS Management Console et ouvrez-la à 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.

  7. Redémarrez l'instance de base de données principale (scripteur) du cluster pour y appliquer les modifications.

  8. Redémarrez ensuite les instances de base de données du lecteur pour leur appliquer les modifications.

Pour modifier un groupe de paramètres de cluster de base de données, utilisez la AWS CLI modify-db-cluster-parameter-groupcommande avec les paramètres obligatoires 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 LinuxmacOS, 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"

Dans 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 console Amazon RDS AWS Management Console et ouvrez-la à 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établir les valeurs par défaut des paramètres d'un groupe de paramètres de cluster de base de données, utilisez la AWS CLI reset-db-cluster-parameter-groupcommande 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 LinuxmacOS, ou Unix :

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

Dans 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 LinuxmacOS, 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"

Dans 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 à l'aide de la commande AWS CLI copy-db-cluster-parameter-group ou de l'opération ClusterParameterGroupCopyDB de l'API RDS.

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 Groupes de paramètres de la console Amazon RDS ou la describe-db-cluster-parameterscommande pour vérifier que votre groupe de paramètres de cluster de base de données est 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.

Vous ne pouvez pas copier un groupe de paramètres de cluster de base de données vers un autre Compte AWS ou Région AWS.

Pour copier un groupe de paramètres de cluster de bases de données

  1. Connectez-vous à la console Amazon RDS AWS Management Console et ouvrez-la à 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 AWS CLI copy-db-cluster-parameter-groupcommande avec les paramètres obligatoires 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 LinuxmacOS, 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"

Dans 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 base de données que vous avez créés pour votre AWS compte.

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 base de données pour un AWS compte

  1. Connectez-vous à la console Amazon RDS AWS Management Console et ouvrez-la à 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 AWS compte, utilisez la AWS CLI describe-db-cluster-parameter-groupscommande.

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 LinuxmacOS, ou Unix :

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

Dans 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 AWS compte, utilisez l'DescribeDBClusterParameterGroupsaction 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 console Amazon RDS AWS Management Console et ouvrez-la à 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 des paramètres d'un groupe de paramètres de cluster de base de données, utilisez la AWS CLI describe-db-cluster-parameterscommande avec le paramètre obligatoire 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

Dans certains cas, les valeurs autorisées pour un paramètre ne sont pas affichées. Il s'agit toujours de paramètres dont la source est la valeur par défaut du moteur de base de données.

Pour afficher les valeurs de ces paramètres, vous pouvez exécuter les instructions SQL suivantes :

  • MySQL :

    -- Show the value of a particular parameter
mysql$ SHOW VARIABLES LIKE '%parameter_name%';

-- Show the values of all parameters
mysql$ SHOW VARIABLES;

  • PostgreSQL :

    -- Show the value of a particular parameter
postgresql=> SHOW parameter_name;

-- Show the values of all parameters
postgresql=> SHOW ALL;

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

Vous pouvez supprimer un groupe de paramètres de cluster de base de données à l'aide de l'API AWS Management Console AWS CLI, ou RDS. Un groupe de paramètres de groupe de paramètres de cluster de base de données est éligible à la suppression uniquement s'il n'est pas associé à un cluster de base de données.

Pour supprimer des groupes de paramètres

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

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

    Les groupes de paramètres apparaissent dans une liste.

  3. Choisissez le nom des groupes de paramètres du cluster de base de données à supprimer.

  4. Choisissez Actions, puis Supprimer.

  5. Vérifiez les noms des groupes de paramètres, puis choisissez Supprimer.

Pour supprimer un groupe de paramètres de cluster de base de données, utilisez la AWS CLI delete-db-cluster-parameter-groupcommande avec le paramètre obligatoire suivant.

  • --db-parameter-group-name

Exemple

L'exemple suivant supprime un groupe de paramètres de cluster de base de données nommé mydbparametergroup.

aws rds delete-db-cluster-parameter-group --db-parameter-group-name mydbparametergroup

Pour supprimer un groupe de paramètres de cluster de base de données, utilisez la DeleteDBClusterParameterGroupcommande API RDS avec le paramètre obligatoire suivant.

  • DBParameterGroupName