

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.

# Groupes de paramètres pour Amazon Aurora
<a name="USER_WorkingWithParamGroups"></a>

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 et clusters de base de données Aurora à des groupes de paramètres. Aurora définit des groupes de paramètres avec des paramètres par défaut. Vous pouvez également définir vos propres groupes de paramètres à l’aide de paramètres personnalisés.

**Topics**
+ [Présentation des groupes de paramètres](parameter-groups-overview.md)
+ [Groupes de paramètres de cluster de bases de données pour les clusters de bases de données Amazon Aurora](USER_WorkingWithDBClusterParamGroups.md)
+ [Groupes de paramètres de base de données pour les instances de base de données Amazon Aurora](USER_WorkingWithDBInstanceParamGroups.md)
+ [Comparaison des groupes de paramètres de bases de données](USER_WorkingWithParamGroups.Comparing.md)
+ [Spécification des paramètres de base de données](USER_ParamValuesRef.md)

# Présentation des groupes de paramètres
<a name="parameter-groups-overview"></a>

Un *groupe de paramètres de cluster de bases de données* sert de conteneur pour les valeurs de configuration du moteur qui sont appliquées à chaque instance de base de données dans un cluster de bases de données Aurora. Par exemple, le modèle de stockage partagé Aurora requiert que chaque instance de base de données d’un cluster Aurora utilise la même valeur pour les paramètres tels que `innodb_file_per_table`. Les paramètres qui affectent l’organisation du stockage physique font donc partie du groupe de paramètres du cluster. Le groupe de paramètres du cluster de bases de données contient également des valeurs par défaut pour tous les paramètres au niveau de l’instance.

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. Les groupes de paramètres de base de données s’appliquent aux instances de base de données à la fois dans Amazon RDS et dans Aurora. Ces paramètres de configuration s’appliquent à des propriétés qui peuvent varier entre les instances de base de données d’un cluster Aurora comme, par exemple, les tailles des mémoires tampons.



**Topics**
+ [Groupes de paramètres par défaut et personnalisés](#parameter-groups-overview.custom)
+ [Paramètres de cluster de bases de données statiques et dynamiques](#parameter-groups-overview.db-cluster)
+ [Paramètres d’instance de base de données statiques et dynamiques](#parameter-groups-overview.db-instance)
+ [Paramètres de jeu de caractères](#parameter-groups-overview.char-sets)
+ [Paramètres et valeurs de paramètres pris en charge](#parameter-groups-overview.supported)

## Groupes de paramètres par défaut et personnalisés
<a name="parameter-groups-overview.custom"></a>

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. De même, si vous créez un cluster de base de données Aurora sans spécifier de groupe de paramètres de cluster de base de données, le cluster de base de données utilise un groupe de paramètres de cluster de base de données par défaut. Chaque groupe de paramètres par défaut contient les 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. Au lieu de cela, vous pouvez effectuer les actions suivantes :

1. Créez un groupe de paramètres.

1. Modifiez les paramètres souhaités. Il n’est pas possible de modifier tous les paramètres du moteur de base de données dans un groupe de paramètres.

1. Modifiez votre instance de base de données ou votre cluster de bases de données afin d’associer le nouveau groupe de paramètres. 

   Pour plus d’informations sur la modification d’un cluster de bases de données ou d’une instance de base de données, consultez [Modification d’un cluster de bases de données Amazon Aurora](Aurora.Modifying.md).
**Note**  
Si vous avez modifié votre instance de base de données pour utiliser un groupe de paramètres personnalisés et que vous démarrez l’instance de base de données, RDS redémarre automatiquement l’instance de base de données dans le cadre du processus de démarrage. Pour les instances RDS for SQL Server Multi-AZ dont l'option de mise en miroir est activée AlwaysOn ou dont l'option de mise en miroir est activée, un basculement est attendu lorsque l'instance est redémarrée après le processus de démarrage.

RDS applique les paramètres statiques et dynamiques modifiés dans un groupe de paramètres nouvellement associé uniquement après le redémarrage de l’instance de base de données. Toutefois, si vous modifiez des paramètres dynamiques dans le groupe de paramètres de base de données après l’avoir associé à l’instance de base de données, ces modifications sont appliquées immédiatement sans redémarrage. Pour plus d’informations sur la modification du groupe de paramètres de base de données, consultez [Modification d’un cluster de bases de données Amazon Aurora](Aurora.Modifying.md).

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. De même, si vous mettez à jour les paramètres d’un groupe de paramètres de cluster de bases de données Aurora, les modifications effectuées s’appliquent à tous les clusters de bases de données Aurora qui sont associés à ce groupe de paramètres du cluster de bases de données.

Si vous ne souhaitez pas créer un groupe de paramètres à partir de zéro, vous pouvez copier un groupe de paramètres existant à l'aide de la AWS CLI [copy-db-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-parameter-group.html)commande command ou de la commande [copy-db-cluster-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-cluster-parameter-group.html). Vous trouverez peut-être utile de copier un groupe de paramètres dans certains cas. Par exemple, vous pouvez vouloir inclure la plupart des valeurs et paramètres personnalisés d’un groupe de paramètres de dans un nouveau groupe de paramètres de .

## Paramètres de cluster de bases de données statiques et dynamiques
<a name="parameter-groups-overview.db-cluster"></a>

Les paramètres de cluster de bases de données sont statiques ou dynamiques. Ils diffèrent comme suit :
+ Lorsque vous modifiez un paramètre statique et que vous enregistrez le groupe de paramètres de base de données d’un cluster, la modification du paramètre est appliquée après le redémarrage manuel des instances de base de données dans chaque cluster de bases de données associé. Lorsque vous utilisez le AWS Management Console pour modifier les valeurs des paramètres statiques du cluster de bases de données, il l'utilise toujours `pending-reboot` pour`ApplyMethod`.
+ Lorsque vous modifiez un paramètre dynamique, par défaut, la modification du paramètre s’applique immédiatement, sans nécessiter de redémarrage. Lorsque vous utilisez la console, elle utilise toujours `immediate` pour `ApplyMethod`. Pour différer la modification des paramètres jusqu'au redémarrage des instances de base de données dans un cluster de base de données associé, utilisez l'API AWS CLI ou RDS. Définissez `ApplyMethod` sur `pending-reboot` pour le changement de paramètre.

Pour plus d'informations sur l'utilisation de AWS CLI pour modifier la valeur d'un paramètre, consultez [modify-db-cluster-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster-parameter-group.html). Pour plus d'informations sur l'utilisation de l'API RDS pour modifier la valeur d'un paramètre, consultez [Modifier DBCluster ParameterGroup](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBClusterParameterGroup.html).

Si vous modifiez le groupe de paramètres du cluster de bases de données associé à un cluster de bases de données, redémarrez les instances de base de données dans le cluster de bases de données. Le redémarrage applique les modifications à toutes les instances de base de données du cluster de bases de données. Pour déterminer si les instances de base de données d’un cluster de bases de données doivent être redémarrées pour appliquer les modifications, exécutez la commande AWS CLI suivante.

`aws rds describe-db-clusters --db-cluster-identifier db_cluster_identifier`

Vérifiez la valeur `DBClusterParameterGroupStatus` de l’instance de base de données principale dans la sortie. Si la valeur est `pending-reboot`, alors redémarrez les instances de base de données du cluster de bases de données.

## Paramètres d’instance de base de données statiques et dynamiques
<a name="parameter-groups-overview.db-instance"></a>

Les paramètres d’instance de base de données sont statiques ou dynamiques. Ils diffèrent comme suit :
+ 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 après le redémarrage manuel des instances de base de données associées. Pour les paramètres statiques, la console utilise toujours `pending-reboot` pour `ApplyMethod`.
+ Lorsque vous modifiez un paramètre dynamique, par défaut, la modification du paramètre s’applique immédiatement, sans nécessiter de redémarrage. Lorsque vous utilisez le AWS Management Console pour modifier les valeurs des paramètres d'une instance de base de données, il l'utilise `immediate` toujours `ApplyMethod` pour les paramètres dynamiques. Pour différer la modification des paramètres jusqu'au redémarrage d'une instance de base de données associée, utilisez l'API AWS CLI ou RDS. Définissez `ApplyMethod` sur `pending-reboot` pour le changement de paramètre.

Pour plus d'informations sur l'utilisation du AWS CLI pour modifier la valeur d'un paramètre, consultez [modify-db-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html). Pour plus d'informations sur l'utilisation de l'API RDS pour modifier la valeur d'un paramètre, consultez [Modifier le DBParameter groupe](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html).

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é, la console affiche le statut **pending-reboot** pour le groupe de paramètres de base de données. Le statut 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.

## Paramètres de jeu de caractères
<a name="parameter-groups-overview.char-sets"></a>

Avant de créer le cluster, définissez tous les paramètres relatifs au jeu de caractères ou au classement de votre base de données dans votre groupe de paramètres. Faites-le également avant d’y créer une base de données. Cela garantit que la base de données par défaut et les nouvelles bases 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, les modifications de paramètre ne sont pas appliquées aux bases de données existantes.

Pour certains moteurs de base de données, 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;
```

Pour plus d’informations sur le changement de jeu de caractères ou de valeurs de classement d’une base de données, consultez la documentation de votre moteur de base de données.

## Paramètres et valeurs de paramètres pris en charge
<a name="parameter-groups-overview.supported"></a>

Pour déterminer les paramètres pris en charge pour votre moteur de base de données, affichez les paramètres du groupe de paramètres de base de données et du groupe de paramètres de cluster de bases de données utilisés par l’instance de base de données ou le cluster de bases de données. Pour plus d’informations, consultez [Affichage des valeurs de paramètres pour un groupe de paramètres de base de données dans Amazon Aurora](USER_WorkingWithParamGroups.Viewing.md) et [Affichage des valeurs de paramètres pour un groupe de paramètres de cluster de base de données dans Amazon Aurora](USER_WorkingWithParamGroups.ViewingCluster.md).

Dans la plupart des cas, vous pouvez spécifier des valeurs de paramètres entiers et booléens au moyen d’expressions, de formules et de fonctions. Les fonctions peuvent inclure une expression de journal mathématique. Cependant, tous les paramètres ne prennent pas en charge les expressions, les formules et les fonctions des valeurs de paramètres. Pour plus d’informations, consultez [Spécification des paramètres de base de données](USER_ParamValuesRef.md).

Dans le cas d’une base de données mondiale Aurora, vous pouvez spécifier différents paramètres de configuration pour les clusters Aurora individuels. Veillez à vérifier que les paramètres sont suffisamment similaires pour générer un comportement cohérent si vous transformez un cluster secondaire en cluster principal. Par exemple, utilisez les mêmes paramètres pour les fuseaux horaires et les jeux de caractères pour tous les clusters d’une base de données mondiale Aurora.

La configuration incorrecte de paramètres dans un groupe de paramètres 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. Essayez de modifier les paramètres des groupes de paramètres sur une instance de base de données ou un cluster de bases de données de test avant d’appliquer ces modifications à une instance de base de données ou un cluster de bases de données de production.

# Groupes de paramètres de cluster de bases de données pour les clusters de bases de données Amazon Aurora
<a name="USER_WorkingWithDBClusterParamGroups"></a>

Les clusters de bases de données Amazon Aurora utilisent les groupes de paramètres de cluster de bases 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.

**Topics**
+ [Paramètres de cluster de bases de données et d’instance de base de données Amazon Aurora](#Aurora.Managing.ParameterGroups)
+ [Création d'un groupe de paramètres de cluster de base de données dans Amazon Aurora](USER_WorkingWithParamGroups.CreatingCluster.md)
+ [Association d’un groupe de paramètres de cluster de bases de données à un cluster de bases de données Amazon Aurora](USER_WorkingWithParamGroups.AssociatingCluster.md)
+ [Modification des paramètres d'un groupe de paramètres de cluster de base de données dans Amazon Aurora](USER_WorkingWithParamGroups.ModifyingCluster.md)
+ [Réinitialisation des paramètres d'un groupe de paramètres de cluster de base de données dans Amazon Aurora](USER_WorkingWithParamGroups.ResettingCluster.md)
+ [Copie d'un groupe de paramètres de cluster de base de données dans Amazon Aurora](USER_WorkingWithParamGroups.CopyingCluster.md)
+ [Répertorier les groupes de paramètres de clusters de bases de données dans Amazon Aurora](USER_WorkingWithParamGroups.ListingCluster.md)
+ [Affichage des valeurs de paramètres pour un groupe de paramètres de cluster de base de données dans Amazon Aurora](USER_WorkingWithParamGroups.ViewingCluster.md)
+ [Suppression d'un groupe de paramètres de cluster de base de données dans Amazon Aurora](USER_WorkingWithParamGroups.DeletingCluster.md)

## Paramètres de cluster de bases de données et d’instance de base de données Amazon Aurora
<a name="Aurora.Managing.ParameterGroups"></a>

 Aurora utilise un système de paramètres de configuration à deux niveaux : 
+  Les paramètres d’un *groupe de paramètres de cluster de base de données* s’appliquent à toute instance de base de données d’un cluster de base de données. Vos données sont stockées dans le sous-système de stockage partagé Aurora. Par conséquent, tous les paramètres concernant la disposition physique des données de table doivent être les mêmes pour toutes les instances de base de données d’un cluster Aurora. De même, étant donné que les instances de base de données Aurora sont connectées par réplication, tous les paramètres de réplication doivent être identiques au sein d’un cluster Aurora. 
+  Les paramètres d’un *groupe de paramètres de base de données* s’appliquent à une seule instance de base de données dans un cluster de bases de données Aurora. Ces paramètres concernent des aspects tels que l’utilisation de la mémoire, que vous pouvez faire varier entre les instances de base de données d’un même cluster Aurora. Par exemple, un cluster contient souvent des instances de base de données ayant des classes d’instance AWS différentes. 

 Chaque cluster Aurora est associé à un groupe de paramètres de cluster de bases de données. Ce groupe de paramètres attribue des valeurs par défaut pour chaque valeur de configuration pour le moteur de base de données correspondant. Le groupe de paramètres de cluster comprend des valeurs par défaut pour les paramètres de niveau cluster et de niveau instance. Chaque instance de base de données au sein d’un cluster alloué ou Aurora Serverless v2 hérite des paramètres du groupe de paramètres de ce cluster de bases de données. 

 Chaque instance de base de données est également associée à un groupe de paramètres de base de données. Les valeurs du groupe de paramètres de base de données peuvent remplacer les valeurs par défaut du groupe de paramètres du cluster. Par exemple, si une instance d’un cluster rencontre des problèmes, vous pouvez lui attribuer un groupe de paramètres de base de données personnalisé. Le groupe de paramètres personnalisés peut contenir des réglages spécifiques pour les paramètres liés au débogage ou à l’optimisation des performances. 

 Aurora affecte des groupes de paramètres par défaut lorsque vous créez un cluster ou une instance de base de données, en fonction du moteur et de la version de base de données spécifiés. Vous pouvez spécifier des groupes de paramètres personnalisés à la place. Vous créez ces groupes de paramètres vous-même, et vous pouvez modifier les valeurs des paramètres. Vous pouvez spécifier ces groupes de paramètres personnalisés au moment de la création. Vous pouvez également modifier ultérieurement un cluster ou une instance de base de données pour utiliser un groupe de paramètres personnalisé. 

 Pour les instances allouées et Aurora Serverless v2, toute valeur de configuration que vous modifiez dans le groupe de paramètres du cluster de bases de données remplace les valeurs par défaut du groupe de paramètres de base de données. Si vous modifiez les valeurs correspondantes dans le groupe de paramètres de base de données, ces valeurs remplacent celles du groupe de paramètres de cluster de bases de données. 

 Les valeurs de paramètre de base de données que vous modifiez sont prioritaires par rapport aux valeurs du groupes de paramètres de cluster de bases de données, même si vous rétablissez la valeur par défaut des paramètres de configuration. Vous pouvez voir quels paramètres sont remplacés à l'aide de la [describe-db-parameters](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameters.html) AWS CLI commande ou de l'opération d'API [Describe DBParameters](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html) RDS. Le champ `Source` contient la valeur `user` si vous avez modifié ce paramètre. Pour réinitialiser un ou plusieurs paramètres afin que la valeur du groupe de paramètres du cluster de base de données soit prioritaire, utilisez la [reset-db-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/reset-db-parameter-group.html) AWS CLI commande ou l'opération d'API RDS [Reset DBParameter Group](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ResetDBParameterGroup.html). 

Les paramètres de clusters et d’instances de bases de données à votre disposition dans Aurora varient en fonction de la compatibilité du moteur de base de données.


| Moteur de base de données | Paramètres | 
| --- | --- | 
|  Aurora MySQL  |  Consultez [Paramètres de configuration d’Aurora MySQL](AuroraMySQL.Reference.ParameterGroups.md).  Pour les clusters Aurora Serverless, vous trouverez des informations supplémentaires dans [Utilisation des groupes de paramètres pour Aurora Serverless v2](aurora-serverless-v2.setting-capacity.md#aurora-serverless-v2.parameter-groups) et [Groupes de paramètres pour Aurora Serverless v1](aurora-serverless-v1.how-it-works.md#aurora-serverless.parameter-groups).   | 
|  Aurora PostgreSQL  |  Consultez [Paramètres Amazon Aurora PostgreSQL.](AuroraPostgreSQL.Reference.ParameterGroups.md).  Pour les clusters Aurora Serverless, vous trouverez des informations supplémentaires dans [Utilisation des groupes de paramètres pour Aurora Serverless v2](aurora-serverless-v2.setting-capacity.md#aurora-serverless-v2.parameter-groups) et [Groupes de paramètres pour Aurora Serverless v1](aurora-serverless-v1.how-it-works.md#aurora-serverless.parameter-groups).   | 

**Note**  
 Les clusters Aurora Serverless v1 ne possèdent que des groupes de paramètres de cluster de bases de données, et non des groupes de paramètres de base de données. Pour les clusters Aurora Serverless v2, vous apportez toutes vos modifications aux paramètres personnalisés dans le groupe de paramètres du cluster de bases de données.   
 Aurora Serverless v2 utilise à la fois les groupes de paramètres de cluster de bases de données et les groupes de paramètres de base de données. Avec Aurora Serverless v2, vous pouvez modifier presque tous les paramètres de configuration. Aurora Serverless v2 remplace les paramètres de configuration liés à la capacité afin que votre charge de travail ne soit pas interrompue lorsque les instances Aurora Serverless v2 sont réduites.   
 Pour en savoir plus sur les paramètres de configuration Aurora Serverless et les paramètres que vous pouvez modifier, consultez [Utilisation des groupes de paramètres pour Aurora Serverless v2](aurora-serverless-v2.setting-capacity.md#aurora-serverless-v2.parameter-groups) et [Groupes de paramètres pour Aurora Serverless v1](aurora-serverless-v1.how-it-works.md#aurora-serverless.parameter-groups). 

# Création d'un groupe de paramètres de cluster de base de données dans Amazon Aurora
<a name="USER_WorkingWithParamGroups.CreatingCluster"></a>

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 bases 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 bases de données. Vous pouvez utiliser la page **Groupes de paramètres** de la [console Amazon RDS](https://console.aws.amazon.com/rds/) ou la [describe-db-cluster-parameters](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-cluster-parameters.html)commande 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.

## Console
<a name="USER_WorkingWithParamGroups.CreatingCluster.CON"></a>

**Pour créer 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 à [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)l'adresse.

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

1. Choisissez **Créer un groupe de paramètres**.

1. Pour **Nom de groupe de paramètres**, entrez le nom du nouveau groupe de paramètres de cluster de bases de données.

1. Pour **Description**, entrez une description pour le nouveau groupe de paramètres de cluster de bases de données.

1. Pour **Type de moteur**, choisissez votre moteur de base de données.

1. Dans la liste **Famille de groupe de paramètres**, choisissez une famille de groupe de paramètres de base de données.

1. Choisissez **Créer**.

## AWS CLI
<a name="USER_WorkingWithParamGroups.CreatingCluster.CLI"></a>

Pour créer un groupe de paramètres de cluster de base de données, utilisez la AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster-parameter-group.html)commande.

L’exemple suivant crée un groupe de paramètres de cluster de bases de données nommé *mydbclusterparametergroup* pour Aurora MySQL version 5.7 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.

**Example**  
Pour Linux, macOS ou Unix :  

```
aws rds create-db-cluster-parameter-group \
    --db-cluster-parameter-group-name mydbclusterparametergroup \
    --db-parameter-group-family aurora-mysql5.7 \
    --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 aurora-mysql5.7 ^
    --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": "aurora-mysql5.7",
        "Description": "My new cluster parameter group",
        "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup"
    }
}
```

## API RDS
<a name="USER_WorkingWithParamGroups.CreatingCluster.API"></a>

Pour créer un groupe de paramètres de cluster de bases de données, utilisez l’action d’API RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBClusterParameterGroup.html).

Incluez les paramètres requis suivants :
+ `DBClusterParameterGroupName`
+ `DBParameterGroupFamily`
+ `Description`

# Association d’un groupe de paramètres de cluster de bases de données à un cluster de bases de données Amazon Aurora
<a name="USER_WorkingWithParamGroups.AssociatingCluster"></a>

Vous pouvez créer vos propres groupes de paramètres de cluster de bases de données à l’aide de paramètres personnalisés. Vous pouvez associer un groupe de paramètres de cluster de bases de données à un cluster de bases 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 un cluster de bases de données.

Pour plus d’informations sur la création d’un groupe de paramètres de cluster de bases de données, consultez [Création d'un groupe de paramètres de cluster de base de données dans Amazon Aurora](USER_WorkingWithParamGroups.CreatingCluster.md). Pour plus d’informations sur la création d’un cluster de bases de données, consultez [Création d’un cluster de bases de données Amazon Aurora](Aurora.CreateInstance.md). Pour plus d’informations sur la modification d’un cluster de bases de données, consultez [Modification d’un cluster de bases de données Amazon Aurora](Aurora.Modifying.md).

**Note**  
Pour les versions d’Aurora PostgreSQL 15.2, 14.7, 13.10, 12.14 et toutes les versions 11, lorsque vous modifiez le groupe de paramètres du cluster de bases de données associé à un cluster de bases de données, redémarrez chaque instance de réplica pour appliquer les modifications.  
Pour déterminer si l’instance de base de données principale d’un cluster de bases de données doit être redémarrée pour appliquer les modifications, exécutez la commande AWS CLI suivante :  
`aws rds describe-db-clusters --db-cluster-identifier db_cluster_identifier`  
Vérifiez la valeur `DBClusterParameterGroupStatus` de l’instance de base de données principale dans la sortie. Si la valeur est `pending-reboot`, redémarrez l’instance de base de données principale du cluster de bases de données.

## Console
<a name="USER_WorkingWithParamGroups.AssociatingCluster.CON"></a>

**Pour associer un groupe de paramètres de cluster de bases de données à un 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/](https://console.aws.amazon.com/rds/).

1. Dans le panneau de navigation, choisissez **Bases de données**, puis sélectionnez le cluster de bases de données que vous souhaitez modifier. 

1. Sélectionnez **Modify**. La page **Modify DB cluster (Modifier le cluster DB)** s’affiche.

1. Modifiez le paramètre **DB cluster parameter group (groupe de paramètres de cluster de bases de données)**. 

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

   La modification est appliquée immédiatement, quel que soit le paramètre **Scheduling of modifications (Planification des modifications)**.

1. Sur la page de confirmation, examinez vos modifications. Si elles sont correctes, choisissez **Modifier le cluster** pour enregistrer vos modifications. 

   Sinon, choisissez **Retour** pour modifier vos modifications, ou choisissez **Annuler** pour les annuler. 

## AWS CLI
<a name="USER_WorkingWithParamGroups.AssociatingCluster.CLI"></a>

Pour associer un groupe de paramètres de cluster de bases de données à un cluster de bases de données, utilisez la commande d’AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) avec les options suivantes :
+ `--db-cluster-name`
+ `--db-cluster-parameter-group-name`

L’exemple suivant associe le groupe de paramètres de base de données `mydbclpg` au cluster de bases de données `mydbcluster`.

**Example**  
Pour Linux, macOS ou Unix :  

```
aws rds modify-db-cluster \
    --db-cluster-identifier mydbcluster \
    --db-cluster-parameter-group-name mydbclpg
```
Pour Windows :  

```
aws rds modify-db-cluster ^
    --db-cluster-identifier mydbcluster ^
    --db-cluster-parameter-group-name mydbclpg
```

## API RDS
<a name="USER_WorkingWithParamGroups.AssociatingCluster.API"></a>

Pour associer un groupe de paramètres de cluster de bases de données à un cluster de bases de données, utilisez l’opération d’API RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) avec les paramètres suivants :
+ `DBClusterIdentifier`
+ `DBClusterParameterGroupName`

# Modification des paramètres d'un groupe de paramètres de cluster de base de données dans Amazon Aurora
<a name="USER_WorkingWithParamGroups.ModifyingCluster"></a>

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 bases de données par défaut. Les modifications apportées à des paramètres dans un groupe de paramètres de cluster de bases de données créé par le client sont appliquées à tous les clusters de bases de données qui sont associés au groupe de paramètres de cluster de bases de données.

## Console
<a name="USER_WorkingWithParamGroups.ModifyingCluster.CON"></a>

**Pour modifier 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 à [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)l'adresse.

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

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

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

1. 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.

1. Sélectionnez **Enregistrer les modifications**.

1. Redémarrez l’instance de base de données principale (d’enregistreur) dans le cluster pour y appliquer les modifications.

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

   Si vous ne redémarrez pas les instances de base de données, l’opération de basculement peut prendre plus de temps que d’habitude.

## AWS CLI
<a name="USER_WorkingWithParamGroups.ModifyingCluster.CLI"></a>

Pour modifier un groupe de paramètres de cluster de base de données, utilisez la AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster-parameter-group.html)commande 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 bases de données nommé *mydbclusterparametergroup*.

**Example**  
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
```

## API RDS
<a name="USER_WorkingWithParamGroups.ModifyingCluster.API"></a>

Pour modifier un groupe de paramètres de cluster de bases de données, utilisez la commande d’API RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBClusterParameterGroup.html) avec les paramètres requis suivants :
+ `DBClusterParameterGroupName`
+ `Parameters`

# Réinitialisation des paramètres d'un groupe de paramètres de cluster de base de données dans Amazon Aurora
<a name="USER_WorkingWithParamGroups.ResettingCluster"></a>

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 bases de données créé par le client sont appliquées à tous les clusters de bases de données qui sont associés au groupe de paramètres de cluster de bases 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.

## Console
<a name="USER_WorkingWithParamGroups.ResettingCluster.CON"></a>

**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 à [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)l'adresse.

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

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

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

1. 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.

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

1. Redémarrez l’instance de base de données principale dans le cluster de bases de données pour appliquer les modifications à toutes les instances de base de données dans le cluster de bases de données.

## AWS CLI
<a name="USER_WorkingWithParamGroups.ResettingCluster.CLI"></a>

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 [https://docs.aws.amazon.com/cli/latest/reference/rds/reset-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/reset-db-cluster-parameter-group.html)commande 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.

**Example**  
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 restaure les valeurs par défaut de `server_audit_logging` et `server_audit_logs_upload` dans le groupe de paramètres de cluster de bases de données nommé *mydbclusterparametergroup*.

**Example**  
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
```

## API RDS
<a name="USER_WorkingWithParamGroups.ResettingCluster.API"></a>

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 [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ResetDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ResetDBClusterParameterGroup.html) 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 dans Amazon Aurora
<a name="USER_WorkingWithParamGroups.CopyingCluster"></a>

Vous pouvez copier des groupes de paramètres de cluster de bases 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 bases 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 bases 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](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-cluster-parameter-group.html) ou de l'opération RDS API [Copy DBCluster ParameterGroup](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBParameterGroup.html).

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 bases 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 bases de données. Vous pouvez utiliser la page **Groupes de paramètres** de la [console Amazon RDS](https://console.aws.amazon.com/rds/) ou la [describe-db-cluster-parameters](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-cluster-parameters.html)commande 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.

## Console
<a name="USER_WorkingWithParamGroups.CopyingCluster.CON"></a>

**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 à [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)l'adresse.

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

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

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

1. 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.

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

1. Choisissez **Copy**.

## AWS CLI
<a name="USER_WorkingWithParamGroups.CopyingCluster.CLI"></a>

Pour copier un groupe de paramètres de cluster de base de données, utilisez la AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-cluster-parameter-group.html)commande 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`.

**Example**  
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"
```

## API RDS
<a name="USER_WorkingWithParamGroups.Copying.API"></a>

Pour copier un groupe de paramètres de cluster de bases de données, utilisez l’opération d’API RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBClusterParameterGroup.html) avec les paramètres requis suivants :
+ `SourceDBClusterParameterGroupIdentifier`
+ `TargetDBClusterParameterGroupIdentifier`
+ `TargetDBClusterParameterGroupDescription`

# Répertorier les groupes de paramètres de clusters de bases de données dans Amazon Aurora
<a name="USER_WorkingWithParamGroups.ListingCluster"></a>

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 bases 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. 

## Console
<a name="USER_WorkingWithParamGroups.ListingCluster.CON"></a>

**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 à [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)l'adresse.

1. Dans le panneau 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 bases de données** pour le **Type**.

## AWS CLI
<a name="USER_WorkingWithParamGroups.ListingCluster.CLI"></a>

Pour répertorier tous les groupes de paramètres de cluster de base de données pour un AWS compte, utilisez la AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-clusterparameter-groups.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-clusterparameter-groups.html)commande.

**Example**  
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": "mydbclusterparametergroup",
            "DBParameterGroupFamily": "aurora-mysql5.7",
            "Description": "My new cluster parameter group",
            "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup"
        }
    ]
}
```

## API RDS
<a name="USER_WorkingWithParamGroups.ListingCluster.API"></a>

Pour répertorier tous les groupes de paramètres de cluster de base de données pour un AWS compte, utilisez l'[https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBClusterParameterGroups.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBClusterParameterGroups.html)action API RDS.

# Affichage des valeurs de paramètres pour un groupe de paramètres de cluster de base de données dans Amazon Aurora
<a name="USER_WorkingWithParamGroups.ViewingCluster"></a>

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.

## Console
<a name="USER_WorkingWithParamGroups.ViewingCluster.CON"></a>

**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 à [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)l'adresse.

1. Dans le panneau 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 bases de données** pour le **Type**.

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

## AWS CLI
<a name="USER_WorkingWithParamGroups.ViewingCluster.CLI"></a>

Pour afficher les valeurs des paramètres d'un groupe de paramètres de cluster de base de données, utilisez la AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-cluster-parameters.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-cluster-parameters.html)commande avec le paramètre obligatoire suivant.
+ `--db-cluster-parameter-group-name`

**Example**  
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": "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"
            ]
        },
        {
            "ParameterName": "aurora_binlog_read_buffer_size",
            "ParameterValue": "5242880",
            "Description": "Read buffer size used by master dump thread when the switch aurora_binlog_use_large_read_buffer is ON.",
            "Source": "engine-default",
            "ApplyType": "dynamic",
            "DataType": "integer",
            "AllowedValues": "8192-536870912",
            "IsModifiable": true,
            "ApplyMethod": "pending-reboot",
            "SupportedEngineModes": [
                "provisioned"
            ]
        },

...
```

## API RDS
<a name="USER_WorkingWithParamGroups.ViewingCluster.API"></a>

Pour afficher les valeurs de paramètre d’un groupe de paramètres de cluster de bases de données, utilisez la commande d’API RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html) 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 dans Amazon Aurora
<a name="USER_WorkingWithParamGroups.DeletingCluster"></a>

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 cluster de bases de données peut être supprimé uniquement s’il n’est pas associé à un cluster de bases de données.

## Console
<a name="USER_WorkingWithParamGroups.DeletingCluster.CON"></a>

**Pour supprimer des groupes de paramètres**

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

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

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

1. Choisissez le nom du groupe de paramètres du cluster de bases de données à supprimer.

1. Choisissez **Actions**, puis **Supprimer**.

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

## AWS CLI
<a name="USER_WorkingWithParamGroups.DeletingCluster.CLI"></a>

Pour supprimer un groupe de paramètres de cluster de base de données, utilisez la AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/delete-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/delete-db-cluster-parameter-group.html)commande avec le paramètre obligatoire suivant.
+ `--db-parameter-group-name`

**Example**  
L’exemple suivant supprime un groupe de paramètres de cluster de bases de données nommé *mydbparametergroup.*  

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

## API RDS
<a name="USER_WorkingWithParamGroups.DeletingCluster.API"></a>

Pour supprimer un groupe de paramètres de cluster de bases de données, utilisez la commande [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteDBClusterParameterGroup.html) de l’API RDS avec le paramètre requis suivant.
+ `DBParameterGroupName`

# Groupes de paramètres de base de données pour les instances de base de données Amazon Aurora
<a name="USER_WorkingWithDBInstanceParamGroups"></a>

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.

**Topics**
+ [Création d’un groupe de paramètres de base de données dans Amazon Aurora](USER_WorkingWithParamGroups.Creating.md)
+ [Association d’un groupe de paramètres de base de données à une instance de base de données dans Amazon Aurora](USER_WorkingWithParamGroups.Associating.md)
+ [Modification de paramètres dans un groupe de paramètres de base de données dans Amazon Aurora](USER_WorkingWithParamGroups.Modifying.md)
+ [Réinitialisation des valeurs par défaut des paramètres d’un groupe de paramètres de base de données dans Amazon Aurora](USER_WorkingWithParamGroups.Resetting.md)
+ [Copie d’un groupe de paramètres de base de données dans Amazon Aurora](USER_WorkingWithParamGroups.Copying.md)
+ [Répertorier les groupes de paramètres de base de données dans Amazon Aurora](USER_WorkingWithParamGroups.Listing.md)
+ [Affichage des valeurs de paramètres pour un groupe de paramètres de base de données dans Amazon Aurora](USER_WorkingWithParamGroups.Viewing.md)
+ [Suppression d’un groupe de paramètres de base de données dans Amazon Aurora](USER_WorkingWithParamGroups.Deleting.md)

# Création d’un groupe de paramètres de base de données dans Amazon Aurora
<a name="USER_WorkingWithParamGroups.Creating"></a>

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

Les limites suivantes s’appliquent aux noms de groupes de paramètres de base 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.mysql8.0`. 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.

## Console
<a name="USER_WorkingWithParamGroups.Creating.CON"></a>

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

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

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

1. Choisissez **Créer un groupe de paramètres**.

1. Pour **Nom de groupe de paramètres**, entrez le nom du nouveau groupe de paramètres de base de données.

1. Pour **Description**, saisissez une description du nouveau groupe de paramètres de bases de données. 

1. Pour **Type de moteur**, choisissez votre moteur de base de données. 

1. Dans la liste **Famille de groupe de paramètres**, choisissez une famille de groupe de paramètres de base de données.

1. Pour **Type**, le cas échéant, choisissez **Groupe de paramètres de base de données**.

1. Choisissez **Créer**.

## AWS CLI
<a name="USER_WorkingWithParamGroups.Creating.CLI"></a>

Pour créer un groupe de paramètres de base de données, utilisez la AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html)commande. 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.

**Example**  
Pour Linux, macOS ou Unix :  

```
aws rds create-db-parameter-group \
    --db-parameter-group-name mydbparametergroup \
    --db-parameter-group-family aurora-mysql5.7 \
    --description "My new parameter group"
```
Pour Windows :  

```
aws rds create-db-parameter-group ^
    --db-parameter-group-name mydbparametergroup ^
    --db-parameter-group-family aurora-mysql5.7 ^
    --description "My new parameter group"
```
Le résultat produit lors de l’exécution de cette commande est semblable à ce qui suit :  

```
DBPARAMETERGROUP  mydbparametergroup  aurora-mysql5.7  My new parameter group					
```

## API RDS
<a name="USER_WorkingWithParamGroups.Creating.API"></a>

Pour créer un groupe de paramètres de base de données, utilisez l’opération d’API RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBParameterGroup.html).

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 dans Amazon Aurora
<a name="USER_WorkingWithParamGroups.Associating"></a>

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' AWS Management Console aide de l'API AWS CLI, de, 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 base de données dans Amazon Aurora](USER_WorkingWithParamGroups.Creating.md). 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 dans un cluster de bases de données](Aurora.Modifying.md#Aurora.Modifying.Instance).

**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 après l’avoir associé à l’instance de base de données, ces modifications sont appliquées immédiatement sans redémarrage.

## Console
<a name="USER_WorkingWithParamGroups.Associating.CON"></a>

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

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

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

1. Sélectionnez **Modify (Modifier)**. La page **Modifier l’instance de base de données** s’affiche.

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

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

1. (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. 

1. 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. 

## AWS CLI
<a name="USER_WorkingWithParamGroups.Associating.CLI"></a>

Pour associer un groupe de paramètres de base de données à une instance de base de données, utilisez la AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html)commande 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. 

**Example**  
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
```

## API RDS
<a name="USER_WorkingWithParamGroups.Associating.API"></a>

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 [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) avec les paramètres suivants :
+ `DBInstanceName`
+ `DBParameterGroupName`

# Modification de paramètres dans un groupe de paramètres de base de données dans Amazon Aurora
<a name="USER_WorkingWithParamGroups.Modifying"></a>

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. 

Il existe deux types de paramètres : les paramètres dynamiques et les paramètres statiques. Les modifications apportées aux paramètres dynamiques sont appliquées à l'instance de base de données immédiatement sans redémarrage. Les modifications apportées aux paramètres statiques ne sont appliquées qu'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\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/images/db-cluster-instance-param-group.png)


## Console
<a name="USER_WorkingWithParamGroups.Modifying.CON"></a>

**Pour modifier des paramètres dans un groupe de paramètres de bases de données**

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

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

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

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

1. 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.

1. Sélectionnez **Save Changes**.

## AWS CLI
<a name="USER_WorkingWithParamGroups.Modifying.CLI"></a>

Pour modifier un groupe de paramètres de base de données, utilisez la AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html)commande 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*.

**Example**  
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
```

## API RDS
<a name="USER_WorkingWithParamGroups.Modifying.API"></a>

Pour modifier un groupe de paramètres de base de données, utilisez l’opération d’API RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html) 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 dans Amazon Aurora
<a name="USER_WorkingWithParamGroups.Resetting"></a>

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. Cependant, 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 l'API AWS CLI ou RDS, vous pouvez rétablir les valeurs par défaut de certains paramètres. Vous pouvez également 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, supposons que 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é. Si tel est le cas, 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\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/images/db-cluster-instance-param-group.png)


**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.

## Console
<a name="USER_WorkingWithParamGroups.Resetting.CON"></a>

**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 console Amazon RDS AWS Management Console et ouvrez-la à [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)l'adresse.

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

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

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

1. 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.

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

## AWS CLI
<a name="USER_WorkingWithParamGroups.Resetting.CLI"></a>

Pour réinitialiser certains ou tous les paramètres d'un groupe de paramètres de base de données, utilisez la AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/reset-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/reset-db-parameter-group.html)commande avec l'option requise 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.

**Example**  
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*.

**Example**  
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
```

## API RDS
<a name="USER_WorkingWithParamGroups.Resetting.API"></a>

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 [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ResetDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ResetDBParameterGroup.html) 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 base de données dans Amazon Aurora
<a name="USER_WorkingWithParamGroups.Copying"></a>

Vous pouvez copier des groupes de paramètres DB personnalisés que vous créez. La copie d’un groupe de paramètres peut s’avérer une solution pratique. Par exemple, lorsque vous avez créé un groupe de paramètres de base de données et que vous souhaitez inclure la plupart de ses valeurs et paramètres personnalisés dans un nouveau groupe de paramètres de base de données. Vous pouvez copier un groupe de paramètres de base de données à l'aide du AWS Management Console. Vous pouvez également utiliser la AWS CLI [copy-db-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-parameter-group.html)commande ou l'opération RDS API [Copy DBParameter Group](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBParameterGroup.html).

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 **Groupes de paramètres** de la [console Amazon RDS](https://console.aws.amazon.com/rds/) ou la [describe-db-parameters](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameters.html)commande pour vérifier que votre groupe de paramètres 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 base de données vers un autre Compte AWS ou Région AWS.

## Console
<a name="USER_WorkingWithParamGroups.Copying.CON"></a>

**Pour copier un groupe de paramètres DB**

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

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

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

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

1. 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.

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

1. Choisissez **Copy**.

## AWS CLI
<a name="USER_WorkingWithParamGroups.Copying.CLI"></a>

Pour copier un groupe de paramètres de base de données, utilisez la AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-parameter-group.html)commande 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`.

**Example**  
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"
```

## API RDS
<a name="USER_WorkingWithParamGroups.Copying.API"></a>

Pour copier un groupe de paramètres de base de données, utilisez l’opération d’API RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBParameterGroup.html) avec les paramètres requis suivants :
+ `SourceDBParameterGroupIdentifier`
+ `TargetDBParameterGroupIdentifier`
+ `TargetDBParameterGroupDescription`

# Répertorier les groupes de paramètres de base de données dans Amazon Aurora
<a name="USER_WorkingWithParamGroups.Listing"></a>

Vous pouvez répertorier les groupes de paramètres 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 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. 

## Console
<a name="USER_WorkingWithParamGroups.Listing.CON"></a>

**Pour répertorier tous les groupes de paramètres de base de données pour un AWS compte**

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

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

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

## AWS CLI
<a name="USER_WorkingWithParamGroups.Listing.CLI"></a>

Pour répertorier tous les groupes de paramètres de base de données d'un AWS compte, utilisez la AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameter-groups.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameter-groups.html)commande.

**Example**  
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
```

## API RDS
<a name="USER_WorkingWithParamGroups.Listing.API"></a>

Pour répertorier tous les groupes de paramètres de base de données d'un AWS compte, utilisez l'[https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameterGroups.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameterGroups.html)opération d'API RDS.

# Affichage des valeurs de paramètres pour un groupe de paramètres de base de données dans Amazon Aurora
<a name="USER_WorkingWithParamGroups.Viewing"></a>

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

## Console
<a name="USER_WorkingWithParamGroups.Viewing.CON"></a>

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

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

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

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

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

## AWS CLI
<a name="USER_WorkingWithParamGroups.Viewing.CLI"></a>

Pour afficher les valeurs des paramètres d'un groupe de paramètres de base de données, utilisez la AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameters.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameters.html)commande avec le paramètre obligatoire suivant.
+ `--db-parameter-group-name`

**Example**  
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
```

## API RDS
<a name="USER_WorkingWithParamGroups.Viewing.API"></a>

Pour afficher les valeurs de paramètre d’un groupe de paramètres de base de données, utilisez la commande d’API RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html) avec le paramètre requis suivant :
+ `DBParameterGroupName`

# Suppression d’un groupe de paramètres de base de données dans Amazon Aurora
<a name="USER_WorkingWithParamGroups.Deleting"></a>

Vous pouvez supprimer un groupe de paramètres de base de données à l'aide de l'API AWS Management Console AWS CLI, ou RDS. Un groupe de paramètres peut être supprimé uniquement s’il n’est pas associé à une instance de base de données.

## Console
<a name="USER_WorkingWithParamGroups.Deleting.CON"></a>

**Pour supprimer un groupe de paramètres de base de données**

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

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

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

1. Choisissez le nom des groupes de paramètres à supprimer.

1. Choisissez **Actions**, puis **Supprimer**.

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

## AWS CLI
<a name="USER_WorkingWithParamGroups.Deleting.CLI"></a>

Pour supprimer un groupe de paramètres de base de données, utilisez la AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/delete-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/delete-db-parameter-group.html)commande avec le paramètre obligatoire suivant.
+ `--db-parameter-group-name`

**Example**  
L’exemple suivant illustre la suppression d’un groupe de paramètres de base de données nommé *mydbparametergroup.*  

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

## API RDS
<a name="USER_WorkingWithParamGroups.Deleting.API"></a>

Pour supprimer un groupe de paramètres de base de données, utilisez la commande [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteDBParameterGroup.html) de l’API RDS avec le paramètre requis suivant.
+ `DBParameterGroupName`

# Comparaison des groupes de paramètres de bases de données
<a name="USER_WorkingWithParamGroups.Comparing"></a>

Vous pouvez utiliser la AWS Management Console pour afficher les différences entre deux groupes de paramètres de base de données.

Les groupes de paramètres doivent tous deux être des groupes de paramètres de base de données, ou bien des groupes de paramètres de cluster de bases de données. Cela est vrai même si le moteur de base de données et la version sont identiques. Par exemple, vous ne pouvez pas comparer un groupe de paramètres de base de données `aurora-mysql8.0` (Aurora MySQL version 3) et un groupe de paramètres de cluster de bases de données `aurora-mysql8.0`.

Vous pouvez comparer des groupes de paramètres de base de données Aurora MySQL et RDS for MySQL, même pour des versions différentes, mais vous ne pouvez pas comparer des groupes de paramètres de base de données Aurora PostgreSQL et RDS pour PostgreSQL.

**Pour comparer deux groupes 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/](https://console.aws.amazon.com/rds/).

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

1. Dans la liste, choisissez les deux groupes de paramètres que vous souhaitez comparer.
**Note**  
Pour comparer un groupe de paramètres par défaut à un groupe de paramètres personnalisé, choisissez d’abord le groupe de paramètres par défaut dans l’onglet **Par défaut**, puis choisissez le groupe de paramètres personnalisés dans l’onglet **Personnalisé**.

1. Dans **Actions**, sélectionnez **Comparer**.

# Spécification des paramètres de base de données
<a name="USER_ParamValuesRef"></a>

Les types de paramètres de base de données sont les suivants :
+ Entier
+ Booléen
+ Chaîne
+ 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 entiers et booléens au moyen d’expressions, de formules et de fonctions. 

**Contents**
+ [Des formules de paramètre de bases de données](#USER_ParamFormulas)
  + [Variables de formule de paramètre de bases de données](#USER_FormulaVariables)
  + [Opérateurs de formule de paramètre de bases de données](#USER_FormulaOperators)
+ [Fonctions de paramètre de bases de données](#USER_ParamFunctions)
+ [Expressions de journal des paramètres de base de données](#USER_ParamLogExpressions)
+ [Exemples de valeurs de paramètre de bases de données](#USER_ParamValueExamples)

## Des formules de paramètre de bases de données
<a name="USER_ParamFormulas"></a>

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 : \$1\$1. 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
<a name="USER_FormulaVariables"></a>

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.

*DBInstanceClassMemory*  
Renvoie un entier correspondant au nombre d’octets de mémoire disponibles pour le processus de base de données. Ce nombre est calculé en interne, en commençant par la quantité totale de mémoire pour la classe d’instance de base de données. Le calcul en soustrait la mémoire réservée au système d’exploitation et aux processus RDS qui gèrent l’instance. Par conséquent, ce nombre est toujours légèrement inférieur aux chiffres de mémoire affichés dans les tables de classes d’instance dans [Classes d'instances de base de données Amazon Aurora](Concepts.DBInstanceClass.md). La valeur exacte dépend d’une combinaison de facteurs. Ils incluent la classe d’instance, le moteur de base de données, et si elle s’applique à une instance RDS ou à une instance faisant partie d’un cluster Aurora. 

*DBInstanceVCPU*  
Renvoie un entier qui représente le nombre d’unités de traitement centralisées virtuelles (vCPU) utilisées par Amazon RDS for gérer l’instance.

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

*TrueIfReplica*  
Renvoie `1` si l’instance de base de données est un réplica en lecture et `0` si ce n’est pas le cas. Il s’agit de la valeur par défaut du paramètre `read_only` dans Aurora MySQL.

### Opérateurs de formule de paramètre de bases de données
<a name="USER_FormulaOperators"></a>

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 : \$1*  
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
<a name="USER_ParamFunctions"></a>

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.  
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 journal des paramètres de base de données
<a name="USER_ParamLogExpressions"></a>

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 : \$1\$1. Exemples :

```
{log(DBInstanceClassMemory/8187281418)*1000}
```

La fonction `log` représente la base du journal 2. Cet exemple utilise également la variable de formule `DBInstanceClassMemory`. Consultez [Variables de formule de paramètre de bases de données](#USER_FormulaVariables). 

## Exemples de valeurs de paramètre de bases de données
<a name="USER_ParamValueExamples"></a>

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

**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. 

**Example 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 Aurora MySQL `table_definition_cache`. Utilisez-la pour définir le nombre de définitions de table qui peuvent être stockées dans le cache de définitions à la moins élevée des valeurs suivantes : `DBInstanceClassMemory`/393040 ou 20 000.  

```
LEAST({DBInstanceClassMemory/393040}, 20000)
```