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 RDS
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 Multi-AZ à des groupes de paramètres. Amazon RDS 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.
**Note**
Certains moteurs de base de données offrent des fonctions supplémentaires que vous pouvez ajouter à votre base de données en tant qu’options dans un groupe d’options. Pour plus d’informations sur les groupes d’options, consultez [Utilisation de groupes d’options](USER_WorkingWithOptionGroups.md).
**Topics**
+ [Présentation des groupes de paramètres](parameter-groups-overview.md)
+ [Groupes de paramètres de base de données pour les instances de base de données Amazon RDS](USER_WorkingWithDBInstanceParamGroups.md)
+ [Utilisation des groupes de paramètres de clusters de bases de données pour les clusters de bases de données Multi-AZ](USER_WorkingWithDBClusterParamGroups.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
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 du cluster de bases de données* ne s’appliquent qu’aux clusters de bases de données multi-AZ. Dans un cluster de bases de données multi-AZ, le groupe de paramètres du cluster de bases de données s’applique à toutes les instances de base de données du cluster. Le groupe de paramètres de base de données par défaut pour le moteur et la version du moteur de base de données est utilisé pour chaque instance de base de données du cluster de bases de données.
**Topics**
+ [Groupes de paramètres par défaut et personnalisés](#parameter-groups-overview.custom)
+ [Paramètres d’instance de base de données statiques et dynamiques](#parameter-groups-overview.db-instance)
+ [Paramètres de cluster de bases de données statiques et dynamiques](#parameter-groups-overview.maz)
+ [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
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 Multi-AZ 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.
L’association d’un nouveau groupe de paramètres de base de données à une instance de base de données a lieu immédiatement. Pour plus d’informations sur la modification d’une instance de base de données, consultez [Modification d'une instance de base de données Amazon RDS](Overview.DBInstance.Modifying.md). Pour plus d’informations sur la modification d’un cluster de bases de données multi-AZ, consultez [Modification d’un cluster de bases de données multi-AZ pour Amazon RDS](modify-multi-az-db-cluster.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'une instance de base de données Amazon RDS](Overview.DBInstance.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 multi-AZ, 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 bases de données dans un nouveau groupe de paramètres de base de données.
## Paramètres d’instance de base de données statiques et dynamiques
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.
**Note**
L'utilisation `pending-reboot` de paramètres dynamiques dans l'API AWS CLI ou RDS sur les instances de base de données RDS pour SQL Server génère une erreur. Utilisez `apply-immediately` sur RDS for SQL Server.
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 cluster de bases de données statiques et dynamiques
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 prend effet après le redémarrage manuel des clusters de bases de données associés. 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 du cluster de bases 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'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).
## Paramètres de jeu de caractères
Avant de créer l’instance ou le cluster de bases de données multi-AZ, 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
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 RDS](USER_WorkingWithParamGroups.Viewing.md) et [Affichage des valeurs de paramètres pour un groupe de paramètres de cluster de base de données ](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).
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 base de données pour les instances de base de données Amazon RDS
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 RDS](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 RDS](USER_WorkingWithParamGroups.Associating.md)
+ [Modification de paramètres dans un groupe de paramètres de base de données dans Amazon RDS](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 RDS](USER_WorkingWithParamGroups.Resetting.md)
+ [Copie d’un groupe de paramètres de base de données dans Amazon RDS](USER_WorkingWithParamGroups.Copying.md)
+ [Répertorier les groupes de paramètres de base de données dans Amazon RDS](USER_WorkingWithParamGroups.Listing.md)
+ [Affichage des valeurs de paramètres pour un groupe de paramètres de base de données dans Amazon RDS](USER_WorkingWithParamGroups.Viewing.md)
+ [Suppression d’un groupe de paramètres de base de données dans Amazon RDS](USER_WorkingWithParamGroups.Deleting.md)
# Création d’un groupe de paramètres de base de données dans Amazon RDS
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
**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
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 MySQL8.0 \
--description "My new parameter group"
```
Pour Windows :
```
aws rds create-db-parameter-group ^
--db-parameter-group-name mydbparametergroup ^
--db-parameter-group-family MySQL8.0 ^
--description "My new parameter group"
```
Le résultat produit lors de l’exécution de cette commande est semblable à ce qui suit :
```
DBPARAMETERGROUP mydbparametergroup mysql8.0 My new parameter group
```
## API RDS
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 RDS
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 RDS](USER_WorkingWithParamGroups.Creating.md). Pour plus d’informations sur la création d’une instance de base de données, consultez [Création d'une instance de base de données Amazon RDS](USER_CreateDBInstance.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 Amazon RDS](Overview.DBInstance.Modifying.md).
**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
**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. Pour plus d’informations, consultez [Utilisation du paramètre de planification des modifications](USER_ModifyInstance.ApplyImmediately.md).
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
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. Pour plus d’informations, consultez [Utilisation du paramètre de planification des modifications](USER_ModifyInstance.ApplyImmediately.md).
**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
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 RDS
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/UserGuide/images/param-reboot.png)
## Console
**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
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
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 RDS
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/UserGuide/images/param-reboot.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
**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
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
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 RDS
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
**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
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
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 RDS
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
**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
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
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 RDS
Vous pouvez obtenir une liste de tous les paramètres dans un groupe de paramètres DB et de leurs valeurs.
## Console
**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
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
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 RDS
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
**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
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
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`
# Utilisation des groupes de paramètres de clusters de bases de données pour les clusters de bases de données Multi-AZ
Les clusters de bases de données Multi-AZ utilisent des 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**
+ [Création d'un groupe de paramètres de cluster de base de données](USER_WorkingWithParamGroups.CreatingCluster.md)
+ [Modification des paramètres d'un groupe de paramètres de cluster de base de données](USER_WorkingWithParamGroups.ModifyingCluster.md)
+ [Réinitialisation des paramètres d'un groupe de paramètres de cluster de base de données](USER_WorkingWithParamGroups.ResettingCluster.md)
+ [Copie d'un groupe de paramètres de cluster de base de données](USER_WorkingWithParamGroups.CopyingCluster.md)
+ [Répertorier les groupes de paramètres de clusters de bases de données](USER_WorkingWithParamGroups.ListingCluster.md)
+ [Affichage des valeurs de paramètres pour un groupe de paramètres de cluster de base de données](USER_WorkingWithParamGroups.ViewingCluster.md)
+ [Suppression d'un groupe de paramètres de cluster de base de données](USER_WorkingWithParamGroups.DeletingCluster.md)
# Création d'un groupe de paramètres de cluster de base de données
Vous pouvez créer un nouveau groupe de paramètres de cluster de base de données à l'aide de l'API AWS Management Console, de AWS CLI, ou de l'API RDS.
Après avoir créé un groupe de paramètres de base de données, attendez au moins cinq minutes avant de créer un cluster de 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.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
**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
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 RDS for MySQL version 8.0 avec une description de « *My new cluster parameter group* » (Mon nouveau groupe de paramètres de cluster).
Incluez les paramètres requis suivants :
+ `--db-cluster-parameter-group-name`
+ `--db-parameter-group-family`
+ `--description`
Pour répertorier toutes les familles de groupes de paramètres, utilisez la commande suivante :
```
aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily"
```
**Note**
La sortie contient des doublons.
**Example**
Pour Linux, macOS ou Unix :
```
aws rds create-db-cluster-parameter-group \
--db-cluster-parameter-group-name mydbclusterparametergroup \
--db-parameter-group-family mysql8.0 \
--description "My new cluster parameter group"
```
Pour Windows :
```
aws rds create-db-cluster-parameter-group ^
--db-cluster-parameter-group-name mydbclusterparametergroup ^
--db-parameter-group-family mysql8.0 ^
--description "My new cluster parameter group"
```
Le résultat produit lors de l’exécution de cette commande est semblable à ce qui suit :
```
{
"DBClusterParameterGroup": {
"DBClusterParameterGroupName": "mydbclusterparametergroup",
"DBParameterGroupFamily": "mysql8.0",
"Description": "My new cluster parameter group",
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup2"
}
}
```
## API RDS
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`
# Modification des paramètres d'un groupe de paramètres de cluster de base de données
Vous pouvez modifier les valeurs des paramètres dans un groupe de paramètres de cluster base de données créé par le client. Vous ne pouvez pas modifier les valeurs des paramètres dans un groupe de paramètres de cluster de 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
**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’ cluster pour y appliquer les modifications.
Si vous ne redémarrez pas le cluster, l’opération de basculement peut prendre plus de temps que d’habitude.
## AWS CLI
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
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
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
**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 le cluster de bases de données.
## AWS CLI
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
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
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
**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
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
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
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
**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
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": "mydbclusterparametergroup2",
"DBParameterGroupFamily": "mysql8.0",
"Description": "My new cluster parameter group",
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup"
}
]
}
```
## API RDS
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
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
**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
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": "activate_all_roles_on_login",
"ParameterValue": "0",
"Description": "Automatically set all granted roles as active after the user has authenticated successfully.",
"Source": "engine-default",
"ApplyType": "dynamic",
"DataType": "boolean",
"AllowedValues": "0,1",
"IsModifiable": true,
"ApplyMethod": "pending-reboot",
"SupportedEngineModes": [
"provisioned"
]
},
{
"ParameterName": "allow-suspicious-udfs",
"Description": "Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded",
"Source": "engine-default",
"ApplyType": "static",
"DataType": "boolean",
"AllowedValues": "0,1",
"IsModifiable": false,
"ApplyMethod": "pending-reboot",
"SupportedEngineModes": [
"provisioned"
]
},
...
```
## API RDS
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
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
**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
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
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`
# Comparaison des groupes de paramètres de bases de données
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
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.
Pour le moteur Oracle, vous pouvez utiliser la variable de formule `DBInstanceClassHugePagesDefault` pour spécifier un paramètre de base de données booléen. Consultez [Variables de formule de paramètre de bases de données](#USER_FormulaVariables).
Pour le moteur PostgreSQL, vous pouvez utiliser une expression pour spécifier un paramètre de base de données booléen. Consultez [Expressions de paramètre de base de données booléennes](#USER_ParamBooleanExpressions).
**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 paramètre de base de données booléennes](#USER_ParamBooleanExpressions)
+ [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
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
Chaque variable de formule renvoie une valeur entière ou booléenne. Les noms des variables sont sensibles à la casse.
*AllocatedStorage*
Renvoie un entier qui représente la taille du volume de données en octets.
*DBInstanceClassHugePagesDefault*
Renvoie une valeur booléenne. Actuellement, la prise en charge ne concerne que les moteurs Oracle.
Pour plus d’informations, consultez [Activation de HugePages pour une instance RDS for Oracle](Oracle.Concepts.HugePages.md).
*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 ](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 MySQL.
### Opérateurs de formule de paramètre de bases de données
Les formules de paramètre DB prennent en charge deux opérateurs : division et multiplication.
*Opérateur de division : /*
Divise le dividende par le diviseur, en renvoyant un quotient entier. Les décimales dans le quotient sont tronquées, pas arrondies.
Syntaxe
```
dividend / divisor
```
Les arguments de dividende et de diviseur doivent être des expressions entières.
*Opérateur de multiplication : \$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
Vous spécifiez les arguments des fonctions de paramètres de base de données sous la forme d'entiers ou de formules. Chaque fonction doit avoir au moins un argument. Spécifiez plusieurs arguments sous la forme d'une liste séparée par des virgules. Cette liste ne peut pas contenir de membres vides, tels que *argument1*,,*argument3*. Les noms de fonctions ne sont pas sensibles à la casse.
*IF*
Renvoie un argument.
Actuellement, la prise en charge ne concerne que les moteurs Oracle et `{DBInstanceClassHugePagesDefault}` est le seul premier argument pris en charge. Pour plus d’informations, consultez [Activation de HugePages pour une instance RDS for Oracle](Oracle.Concepts.HugePages.md).
Syntaxe
```
IF(argument1, argument2, argument3)
```
Renvoie le deuxième argument si le premier a la valeur true. Sinon, renvoie le troisième argument.
*GREATEST*
Renvoie la plus grande valeur depuis une liste d'entiers ou de formules de paramètres.
Syntaxe
```
GREATEST(argument1, argument2,...argumentn)
```
Renvoie un entier.
*LEAST*
Renvoie la plus petite valeur depuis une liste d'entiers ou de formules de paramètres.
Syntaxe
```
LEAST(argument1, argument2,...argumentn)
```
Renvoie un entier.
*SUM*
Ajoute les valeurs des formules de paramètres ou d'entiers spécifiés.
Syntaxe
```
SUM(argument1, argument2,...argumentn)
```
Renvoie un entier.
## Expressions de paramètre de base de données booléennes
Une expression de paramètre de base de données booléenne se réduit à une valeur booléenne de 1 ou 0. L'expression est insérée entre guillemets.
**Note**
Les expressions de paramètres de base de données booléennes ne sont prises en charge que pour le moteur PostgreSQL.
**Syntaxe**
```
"expression operator expression"
```
Les deux expressions doivent se réduire à des entiers. Une expression peut être l'un des éléments suivants :
+ Une constante entière
+ Une formule de paramètre de base de données
+ Une fonction de paramètre de base de données
+ Une variable de paramètre de base de données
Les expressions de paramètres de base de données booléennes prennent en charge les opérateurs d'inégalité suivants :
*L'opérateur supérieur à : >*
Syntaxe
```
"expression > expression"
```
*L'opérateur inférieur à : <*
Syntaxe
```
"expression < expression"
```
* Les opérateurs supérieur ou égal à : >=, =>*
Syntaxe
```
"expression >= expression"
"expression => expression"
```
*Les opérateurs inférieur ou égal à : <=, =<*
Syntaxe
```
"expression <= expression"
"expression =< expression"
```
**Example utilisation d'une expression de paramètre de base de données booléenne**
L'exemple d'expression de paramètre de base de données booléenne suivant compare le résultat d'une formule de paramètre à un entier. Il le fait pour modifier le paramètre de base de données booléen `wal_compression` d'une instance de base de données PostgreSQL. L'expression de paramètre compare le nombre de vCPU à la valeur 2. Si le nombre de VCPU est supérieur à 2, le paramètre de base de données `wal_compression` est alors défini à la valeur true.
```
aws rds modify-db-parameter-group --db-parameter-group-name group-name \
--parameters "ParameterName=wal_compression,ParameterValue=\"{DBInstanceVCPU} > 2\" "
```
## Expressions de journal des paramètres de base de données
Vous pouvez définir une valeur de paramètre de base de données entier à une expression de journal. Vous insérez l’expression entre des accolades : \$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).
**Note**
Pour le moment, vous ne pouvez pas spécifier le paramètre `innodb_log_file_size` MySQL avec une autre valeur qu'un entier.
## Exemples de valeurs de paramètre de bases de données
Ces exemples montrent l'utilisation de formules, de fonctions et d'expressions pour les valeurs des paramètres de base de données.
**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 GREATEST**
Vous pouvez spécifier la fonction `GREATEST` dans un paramètre de processus Oracle. Utilisez-la pour définir le nombre de processus utilisateur sur le plus grand des deux nombres : 80 ou `DBInstanceClassMemory` divisé par 9 868 951.
```
GREATEST({DBInstanceClassMemory/9868951},80)
```
**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 MySQL `max_binlog_cache_size`. Utilisez-la pour définir la taille de cache maximale qu'une transaction peut utiliser dans une instance MySQL à la moins élevée des valeurs suivantes : 1 Mo ou `DBInstanceClass`/256.
```
LEAST({DBInstanceClassMemory/256},10485760)
```