

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.

# Configuration d'une instance de base de données Amazon RDS
<a name="CHAP_RDS_Configuring"></a>

Cette section décrit comment configurer votre instance de base de données Amazon RDS. Avant de créer une instance de base de données, choisissez la classe d'instance de base de données qui exécutera l'instance de base de données. Décidez également où l'instance de base de données sera exécutée en choisissant une AWS région. Créez ensuite l'instance de base de données.

Vous pouvez configurer une instance de base de données avec un groupe d'options et un groupe de paramètres de base de données.
+ Un *groupe d'options* spécifie des fonctions, appelées options, qui sont disponibles pour une instance de base de données Amazon RDS spécifique.
+ 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 options et paramètres disponibles dépendent du moteur de base de données et de la version du moteur de base de données. Vous pouvez spécifier un groupe d'options et un groupe de paramètres de base de données lorsque vous créez une instance de base de données. Vous pouvez également modifier une instance de base de données pour les spécifier.

**Topics**
+ [Création d'une instance de base de données Amazon RDS](USER_CreateDBInstance.md)
+ [Création de ressources Amazon RDS () avec AWS CloudFormation](creating-resources-with-cloudformation.md)
+ [Connexion à une instance de base de données Amazon RDS](CHAP_CommonTasks.Connect.md)
+ [Utilisation de groupes d’options](USER_WorkingWithOptionGroups.md)
+ [Groupes de paramètres pour Amazon RDS](USER_WorkingWithParamGroups.md)
+ [Création d'un ElastiCache cache Amazon à l'aide des paramètres de l'instance de base de données Amazon RDS du cluster de bases](creating-elasticache-cluster-with-RDS-settings.md)
+ [Migration automatique des bases de données EC2 vers Amazon Aurora () à l'aide de AWS Database Migration Service](USER_DMS_migration.md)
+ [Tutoriel : Création d'un de base de données MySQL avec un paramètre personnalisé et un nouveau groupe d'options](tutorial-creating-custom-OPG.md)

# Création d'une instance de base de données Amazon RDS
<a name="USER_CreateDBInstance"></a>

La composante de base de Amazon RDS est l'instance de base de données dans laquelle vous créez vos bases de données. Vous choisissez les caractéristiques propres au moteur de l'instance de base de données lorsque vous la créez. Vous choisissez également la capacité de stockage, le processeur, la mémoire, etc. de l' AWS instance sur laquelle le serveur de base de données s'exécute.

**Topics**
+ [Prérequis pour l'instance de base de données](#USER_CreateDBInstance.Prerequisites)
+ [Création d’une instance de base de données](#USER_CreateDBInstance.Creating)
+ [Paramètres des instances de base de données](USER_CreateDBInstance.Settings.md)

## Prérequis pour l'instance de base de données
<a name="USER_CreateDBInstance.Prerequisites"></a>

**Important**  
Avant de pouvoir créer une instance de base de données Amazon RDS, effectuez les tâches indiquées dans [Configuration de votre environnement Amazon RDS](CHAP_SettingUp.md).

Les conditions préalables suivantes sont requises pour créer une instance de base de données.

**Topics**
+ [Configurer le réseau pour l'instance de la base de données](#USER_CreateDBInstance.Prerequisites.VPC)
+ [Prérequis supplémentaires](#USER_CreateDBInstance.Prerequisites.Additional)

### Configurer le réseau pour l'instance de la base de données
<a name="USER_CreateDBInstance.Prerequisites.VPC"></a>

Vous ne pouvez créer une instance de base de données Amazon RDS que dans un cloud privé virtuel (VPC) basé sur un service Amazon VPC. En outre, il doit se trouver dans une zone Région AWS comportant au moins deux zones de disponibilité. Le groupe de sous-réseaux de base de données que vous choisissez pour l'instance de bases de données doit couvrir au moins deux zones de disponibilité. Cette configuration vous permet de configurer un déploiement Multi-AZ lorsque vous créez l'instance de base de données ou de passer facilement à un déploiement ultérieur.

Pour configurer la connectivité entre votre nouvelle instance de base de données et une instance Amazon EC2 dans le même VPC, vous pouvez le faire pendant la création de l'instance de base de données. Pour connecter votre instance de base de données à partir de ressources autres que des instances EC2 dans le même VPC, configurez les connexions réseau manuellement.

**Topics**
+ [Configurer la connectivité réseau automatique avec une instance EC2](#USER_CreateDBInstance.Prerequisites.VPC.Automatic)
+ [Configuration manuelle du réseau](#USER_CreateDBInstance.Prerequisites.VPC.Manual)

#### Configurer la connectivité réseau automatique avec une instance EC2
<a name="USER_CreateDBInstance.Prerequisites.VPC.Automatic"></a>

Lorsque vous créez une instance de base de données RDS, vous pouvez utiliser le AWS Management Console pour configurer la connectivité entre une instance EC2 et la nouvelle instance de base de données. Dans ce cas, RDS configure automatiquement votre VPC et vos paramètres réseau. L'instance de base de données est créée dans le même VPC que l'instance EC2 afin que cette dernière puisse accéder à l'instance de base de données.

Voici les conditions requises pour connecter une instance EC2 à l'instance de base de données :
+ L'instance EC2 doit exister dans le Région AWS avant de créer l'instance de base de données.

  Si aucune instance EC2 n'existe dans le Région AWS, la console fournit un lien pour en créer une.
+ L'utilisateur qui crée l'instance de base de données doit avoir les autorisations nécessaires pour effectuer les opérations suivantes :
  + `ec2:AssociateRouteTable` 
  + `ec2:AuthorizeSecurityGroupEgress` 
  + `ec2:AuthorizeSecurityGroupIngress` 
  + `ec2:CreateRouteTable` 
  + `ec2:CreateSubnet` 
  + `ec2:CreateSecurityGroup` 
  + `ec2:DescribeInstances` 
  + `ec2:DescribeNetworkInterfaces` 
  + `ec2:DescribeRouteTables` 
  + `ec2:DescribeSecurityGroups` 
  + `ec2:DescribeSubnets` 
  + `ec2:ModifyNetworkInterfaceAttribute` 
  + `ec2:RevokeSecurityGroupEgress` 

Cette option permet de créer une instance de base de données privée. L'instance de base de données utilise un groupe de sous-réseaux de base de données avec uniquement des sous-réseaux privés pour restreindre l'accès aux ressources au sein du VPC.

Pour connecter une instance EC2 à l'instance de base de données, choisissez **Connect to an EC2 compute resource** (Se connecter à une ressource de calcul EC2) dans la section **Connectivity** (Connectivité) de la page **Create database** (Créer une base de données).

![\[Connecter une instance EC2\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/ec2-set-up-connection-create.png)


Lorsque vous choisissez **Connect to an EC2 compute resource** (Se connecter à une ressource de calcul EC2), RDS définit automatiquement les options suivantes. Vous ne pouvez pas modifier ces paramètres à moins de choisir de ne pas établir de connectivité avec une instance EC2 en sélectionnant **Don’t connect to an EC2 compute resource** (Ne pas se connecter à une ressource de calcul EC2).


****  

| Option console | Réglage automatique | 
| --- | --- | 
|  **Network type** (Type de réseau)  |  RDS définit le type de réseau sur **IPv4**. Actuellement, le mode double pile n'est pas pris en charge lorsque vous établissez une connexion entre une instance EC2 et l'instance de base de données.  | 
|  **Cloud privé virtuel (VPC)**  |  RDS définit le VPC comme celui qui est employé pour l’instance EC2.  | 
|  **Groupe de sous-réseaux de base de données**  | RDS nécessite un groupe de sous-réseaux de base de données avec un sous-réseau privé dans la même zone de disponibilité que l’instance EC2. Si un groupe de sous-réseau de base de données répondant à cette exigence existe, RDS utilise alors le groupe de sous-réseau de base de données existant. Par défaut, cette option est définie sur Automatic setup (Configuration automatique). Lorsque vous choisissez **Automatic setup** (Configuration automatique) et qu’aucun groupe de sous-réseaux de base de données ne répond à cette exigence, l’action suivante se produit. RDS utilise trois sous-réseaux privés disponibles dans trois zones de disponibilité, l’une des zones de disponibilité étant la même que pour l’instance EC2. Si un sous-réseau privé n’est pas disponible dans une zone de disponibilité, RDS crée un sous-réseau privé dans la zone de disponibilité. RDS crée ensuite le groupe de sous-réseau de base de données.Lorsqu’un sous-réseau privé est disponible, RDS utilise la table de routage qui lui est associée avec le sous-réseau et ajoute les sous-réseaux qu’il crée à cette table de routage. Lorsqu’aucun sous-réseau privé n’est disponible, RDS crée une table de routage sans accès à la passerelle Internet et ajoute les sous-réseaux qu’il crée à la table de routage.RDS vous permet également d’utiliser des groupes de sous-réseaux de base de données existants. Sélectionnez **Choose existing** (Choisir existants) si vous souhaitez utiliser un groupe de sous-réseaux de base de données existant de votre choix.  | 
|  **Accès public**  |  RDS choisit **No** (Non) pour que l'instance de base de données ne soit pas publiquement accessible. Pour des raisons de sécurité, il est préférable de garder la base de données privée et de s'assurer qu'elle n'est pas accessible depuis Internet.  | 
|  **VPC security group (firewall)** [Groupe de sécurité VPC (pare-feu)]  |  RDS crée un nouveau groupe de sécurité qui est associé à l'instance de base de données. Le groupe de sécurité est nommé `rds-ec2-n`, où `n` est un nombre. Ce groupe de sécurité comprend une règle d'entrée avec le groupe de sécurité EC2 VPC (pare-feu) comme source. Ce groupe de sécurité associé à l'instance de base de données permet à l'instance EC2 d'accéder à l'instance de base de données. RDS crée également un groupe de sécurité qui est employé avec l'instance EC2. Le groupe de sécurité est nommé `ec2-rds-n`, où `n` est un nombre. Ce groupe de sécurité comprend une règle de sortie avec le groupe de sécurité VPC de l'instance de base de données comme source. Ce groupe de sécurité permet à l'instance EC2 d'envoyer du trafic à l'instance de base de données. Vous pouvez ajouter un autre groupe de sécurité en sélectionnant **Create new** (Créer nouveau) et en saisissant le nom du nouveau groupe de sécurité. Vous pouvez ajouter des groupes de sécurité existants en choisissant **Choose existing** (Choisir existant) et en sélectionnant les groupes de sécurité à ajouter.  | 
|  **Zone de disponibilité**  |  Lorsque vous choisissez **Single DB instance** (Instance de base de données unique) dans **Availability & durability** (Disponibilité et durabilité) (déploiement Mono-AZ), RDS choisit la zone de disponibilité de l'instance EC2. Lorsque vous choisissez l'option **Multi-AZ DB instance** (Instance de base de données multi-AZ) dans **Availability & durability** (Disponibilité et durabilité) (déploiement d'une instance de base de données multi-AZ), RDS choisit la zone de disponibilité de l'instance EC2 pour une instance de base de données dans le déploiement. RDS choisit de manière aléatoire une zone de disponibilité différente pour l'autre instance de base de données. L'instance de base de données principale ou le réplica secondaire est créé(e) dans la même zone de disponibilité que l'instance EC2. Lorsque vous choisissez **Multi-AZ DB instance** (Instance de base de données Multi-AZ), il peut y avoir des coûts associés aux zones de disponibilité croisées si l'instance de base de données et l'instance EC2 se trouvent dans des zones de disponibilité différentes.  | 

Pour plus d’informations sur ces paramètres, consultez la page [Paramètres des instances de base de données](USER_CreateDBInstance.Settings.md).

Si vous modifiez ces paramètres après la création de l'instance de base de données, ces modifications peuvent affecter la connexion entre l'instance EC2 et l'instance de base de données.

#### Configuration manuelle du réseau
<a name="USER_CreateDBInstance.Prerequisites.VPC.Manual"></a>

Pour connecter votre instance de base de données à partir de ressources autres que des instances EC2 dans le même VPC, configurez les connexions réseau manuellement. Si vous utilisez le AWS Management Console pour créer votre instance de base de données, Amazon RDS peut créer automatiquement un VPC pour vous. Une autre solution consiste à utiliser un VPC existant ou à créer un VPC pour votre instance de base de données. Quelle que soit l'approche adoptée, votre VPC doit comporter au moins un sous-réseau dans chacune d'au moins deux zones de disponibilité pour que vous puissiez l'utiliser avec une instance de base de données RDS. 

Par défaut, Amazon RDS crée l'instance de base de données et la zone de disponibilité automatiquement pour vous. Pour choisir une zone de disponibilité spécifique, vous devez changer le paramètre **Availability & durability** (Disponibilité et durabilité) en **Single DB instance** (Instance de base de données unique). Ce faisant, vous exposez un paramètre de **zone de disponibilité** qui vous permet de choisir parmi les zones de disponibilité de votre VPC. Cependant, si vous choisissez un déploiement Multi-AZ, RDS choisit automatiquement la zone de disponibilité de l'instance de base de données principale ou de l'instance de base de données en écriture, et le paramètre **Availability Zone** (Zone de disponibilité) n'apparaît pas.

Dans certains cas, vous pouvez ne pas avoir de VPC par défaut ou vous n'avez créé aucun VPC. Dans ces cas, vous pouvez demander à Amazon RDS de créer automatiquement un VPC à votre place lorsque vous créez une instance de base de données à partir de la console. Sinon, procédez comme suit :
+ Créez un VPC avec au moins un sous-réseau dans chacune des deux zones de disponibilité dans Région AWS lesquelles vous souhaitez déployer votre instance de base de données. Pour plus d’informations, consultez [Utilisation d’une instance de base de données dans un VPC](USER_VPC.WorkingWithRDSInstanceinaVPC.md#Overview.RDSVPC.Create) et [Tutoriel : Création d'un VPC à utiliser avec un ) IPv4](CHAP_Tutorials.WebServerDB.CreateVPC.md).
+ Spécifiez un groupe de sécurité VPC qui autorise les connexions à votre instance de bases de données. Pour plus d’informations, consultez [Créer un groupe de sécurité qui autorise l'accès à votre instance de base de données dans votre VPC](CHAP_SettingUp.md#CHAP_SettingUp.SecurityGroup) et [Contrôle d’accès par groupe de sécurité](Overview.RDSSecurityGroups.md).
+ Spécifiez un groupe de sous-réseaux de base de données RDS définissant au moins deux sous-réseaux du VPC pouvant être utilisés par l'instance de bases de données. Pour de plus amples informations, veuillez consulter [Utilisation de groupes de sous-réseaux DB](USER_VPC.WorkingWithRDSInstanceinaVPC.md#USER_VPC.Subnets).

Si vous souhaitez vous connecter à une ressource qui ne se trouve pas dans le même VPC que l'instance de base de données, consultez les scénarios appropriés dans [Scénarios d’accès à une instance de base de données d’un VPC](USER_VPC.Scenarios.md).

### Prérequis supplémentaires
<a name="USER_CreateDBInstance.Prerequisites.Additional"></a>

Avant de créer votre instance de base de données, tenez compte des conditions préalables supplémentaires suivantes :
+ Si vous vous connectez à AWS l'aide d'informations d'identification Gestion des identités et des accès AWS (IAM), votre AWS compte doit disposer de certaines politiques IAM. Elles accordent les autorisations requises pour effectuer des opérations Amazon RDS. Pour de plus amples informations, veuillez consulter [Identity and Access Management pour Amazon RDS](UsingWithRDS.IAM.md).

  Pour utiliser IAM pour accéder à la console RDS, connectez-vous à l'aide de vos informations d'identification AWS Management Console d'utilisateur IAM. Accédez ensuite à la console Amazon RDS à [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)l'adresse.
+ Pour personnaliser les paramètres de configuration à votre instance de base de données, spécifiez un groupe de paramètres de base de données avec les paramètres requis. Pour plus d'informations sur la création ou la modification d'un groupe de paramètres de base de données, consultez [Groupes de paramètres pour Amazon RDS](USER_WorkingWithParamGroups.md). 
**Important**  
Si vous utilisez le modèle BYOL pour Amazon RDS for Db2, avant de créer une instance de base de données, vous devez d’abord créer un groupe de paramètres personnalisé contenant vos IBM Site ID et IBM Customer ID. Pour de plus amples informations, veuillez consulter [Apportez votre propre licence (BYOL) pour Db2](db2-licensing.md#db2-licensing-options-byol).
+ Déterminez le numéro de TCP/IP port à spécifier pour votre instance de base de données. Dans certaines entreprises, les pare-feu bloquent les connexions à ces ports par défaut des instances de base de données RDS. Si le pare-feu de votre entreprise bloque le port par défaut, choisissez un autre port pour votre instance de base de données. Les ports par défaut pour les moteurs de base de données Amazon RDS sont les suivants :    
<a name="dbengineports"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.html)

  Pour RDS for SQL Server, les ports suivants sont réservés, et vous ne pouvez pas les utiliser au moment de créer une instance de base de données : `1234, 1434, 3260, 3343, 3389, 47001,` et `49152-49156`.

## Création d’une instance de base de données
<a name="USER_CreateDBInstance.Creating"></a>

Vous pouvez créer une instance de base de données Amazon RDS à l'aide de l' AWS Management Console API AWS CLI, de ou de l'API RDS. 

**Note**  
Pour RDS for Db2, nous vous recommandons de configurer les éléments nécessaires à votre modèle de licence avant de créer une instance de base de données RDS for Db2. Pour de plus amples informations, veuillez consulter [Options de licence Amazon RDS for Db2](db2-licensing.md). 

### Console
<a name="USER_CreateDBInstance.CON"></a>

Vous pouvez créer une instance de base de AWS Management Console données en utilisant **Easy create** activé ou non activé. Lorsque l’option **Easy create (Création facile)** est activée, vous spécifiez uniquement le type de moteur, la taille de l’instance, ainsi que l’identifiant d’instance de base de données. **Easy create (Création facile)** utilise les paramètres par défaut pour les autres options de configuration. Lorsque **Easy create (Création facile)** est désactivé, vous spécifiez davantage d'options de configuration lors de la création d'une base de données, notamment en matière de disponibilité, de sécurité, de sauvegardes et de maintenance.

**Note**  
Dans la procédure suivante, **Standard create** (Création standard) est activé et **Easy create** (Création facile) est désactivé. Cette procédure utilise Microsoft SQL Server à titre d'exemple.  
Pour obtenir des exemples qui utilisent l'option **Easy create** (Création facile) pour vous aider à créer et à vous connecter à des exemples d'instances de base de données pour chaque moteur, consultez [Mise en route avec Amazon RDS](CHAP_GettingStarted.md).

**Pour créer 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 coin supérieur droit de la console Amazon RDS, choisissez la région AWS dans laquelle vous voulez créer l'instance de base de données.

1. Dans la panneau de navigation, choisissez **Databases (Bases de données)**.

1. Choisissez **Créer une base de données**, puis **Création standard**.

1. Pour **Type de moteur**, choisissez IBM Db2, MariaDB, Microsoft SQL Server, MySQL, Oracle ou PostgreSQL.

   **Microsoft SQL Server** est illustré ici.   
![\[Sélection de moteur\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/create-instance-sqlserver.png)

1. Pour **Type de gestion de base de données**, si vous utilisez Oracle ou SQL Server, choisissez **Amazon RDS** ou **Amazon RDS Custom**.

   **Amazon RDS** est illustré ici. Pour plus d'informations sur RDS Custom, consultez [Amazon RDS Custom](rds-custom.md).

1. Dans **Édition**, si vous utilisez Db2, Oracle ou SQL Server, choisissez l’édition du moteur de base de données que vous souhaitez utiliser.

   MySQL n'a qu'une seule option pour l'édition, tandis que MariaDB et PostgreSQL n'en ont aucune.

1. Dans **Version**, choisissez la version du moteur.

1. Dans **Templates (Modèles)**, sélectionnez le modèle qui correspond à votre cas d'utilisation. Si vous choisissez **Production**, les éléments suivants sont présélectionnés lors d'une étape ultérieure :
   + Option de basculement **Multi-AZ**
   + Option de stockage **SSD à IOPS provisionnées (io1)**
   + Option **Enable deletion protection (Activer la protection contre la suppression)**

   Ces fonctions sont recommandées pour tous les environnements de production. 
**Note**  
Les choix de modèles varient selon l'édition.

1. Dans la section **Settings (Paramètres)**, ouvrez **Credential Settings (Paramètres des informations d’identification)**. Ensuite, procédez comme suit :

   1. (Facultatif) Changez la valeur de **Master username (Nom d'utilisateur principal)**.

   1. Choisissez l’une des options suivantes de gestion des informations d’identification :
      + **Géré dans AWS Secrets Manager**

        Dans **Sélectionner la clé de chiffrement**, choisissez soit une clé KMS créée par Secrets Manager, soit une clé que vous avez créée. 
**Note**  
C'est la technique la plus sûre AWS Secrets Manager que nous recommandons pour gérer les informations d'identification. Des frais supplémentaires s’appliquent. Pour de plus amples informations, veuillez consulter [Gestion des mots de passe avec Amazon RDS, et AWS Secrets Manager](rds-secrets-manager.md).
      + **Autogéré**

        Pour spécifier un mot de passe, désactivez la case à cocher **Générer automatiquement un mot de passe**, le cas échéant. Saisissez le même mot de passe dans **Mot de passe principal** et **Confirmer le mot de passe principal**.

1. (Facultatif) Configurez une connexion à une ressource de calcul pour cette instance de base de données.

   Vous pouvez configurer la connectivité entre une instance Amazon EC2 et la nouvelle instance de base de données pendant la création de l'instance de base de données. Pour de plus amples informations, veuillez consulter [Configurer la connectivité réseau automatique avec une instance EC2](#USER_CreateDBInstance.Prerequisites.VPC.Automatic).

1. Dans la section **Connectivité** sous **Groupe de sécurité VPC (pare-feu)**, si vous sélectionnez **Créer**, un groupe de sécurité VPC est créé avec une règle entrante qui autorise l'adresse IP de votre ordinateur local à accéder à la base de données. 

1. Pour les sections restantes, spécifiez vos paramètres d’instance de base de données. Pour plus d'informations sur chaque paramètre, consultez [Paramètres des instances de base de données](USER_CreateDBInstance.Settings.md). 

1. Choisissez **Create database (Créer une base de données)**. 

   Si vous choisissez de générer un mot de passe automatiquement, le bouton **View credential details (Afficher les informations d'identification)** apparaît sur la page **Databases (Bases de données)**.

   Pour afficher l'identifiant principal et le mot de passe pour l'instance de base de données, choisissez **View credential details (Afficher les informations d'identification)**.

   Pour vous connecter à l'instance de base de données en tant qu'utilisateur principal, utilisez le nom d'utilisateur et le mot de passe affichés.
**Important**  
Vous ne pourrez pas afficher le mot de passe de l’utilisateur principal de nouveau. Si vous ne l'enregistrez pas, il sera peut-être nécessaire de le modifier. Si vous devez changer le mot de passe de l'utilisateur principal une fois l'instance de base de données disponible, faites-le en modifiant l'instance de base de données. 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).

1. Pour **Databases** (Bases de données), choisissez le nom de la nouvelle instance de base de données.

   Sur la console RDS, les détails de la nouvelle instance de base de données s'affichent. L'instance de base de données a le statut **Creating (Création en cours)** jusqu'à ce qu'elle soit créée et prête à l'emploi. Lorsque le statut devient **Available (Disponible)**, vous pouvez vous connecter à l'instance de base de données. En fonction du stockage et de la classe d'instance de base de données alloués, la mise à disposition de la nouvelle instance de base de données peut nécessiter plusieurs minutes.   
![\[Détails de mes instances de base de données\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/SQLSvr-Launch05.png)

### AWS CLI
<a name="USER_CreateDBInstance.CLI"></a>



**Note**  
Si vous souhaitez utiliser la licence DB2 via AWS Marketplace, vous devez d'abord vous abonner AWS Marketplace et vous enregistrer auprès d'IBM en utilisant le AWS Management Console. Pour de plus amples informations, veuillez consulter [Abonnement aux listes de Db2 Marketplace et inscription auprès de IBM](db2-licensing.md#db2-marketplace-subscribing-registering).

Pour créer une instance de base de données à l'aide de AWS CLI, appelez la [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)commande avec les paramètres suivants :
+ `--db-instance-identifier`
+ `--db-instance-class`
+ `--vpc-security-group-ids`
+ `--db-subnet-group`
+ `--engine`
+ `--master-username`
+ `--master-user-password` ou `--manage-master-user-password`
+ `--allocated-storage`
+ `--backup-retention-period`

Pour plus d’informations sur chaque paramètre, consultez [Paramètres des instances de base de données](USER_CreateDBInstance.Settings.md).

Cet exemple utilise Microsoft SQL Server.

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

```
 1. aws rds create-db-instance \
 2.     --engine sqlserver-se \
 3.     --db-instance-identifier mymsftsqlserver \
 4.     --allocated-storage 250 \
 5.     --db-instance-class db.t3.large \
 6.     --vpc-security-group-ids mysecuritygroup \
 7.     --db-subnet-group mydbsubnetgroup \
 8.     --master-username masterawsuser \
 9.     --manage-master-user-password \
10.     --backup-retention-period 3
```
Pour Windows :  

```
 1. aws rds create-db-instance ^
 2.     --engine sqlserver-se ^
 3.     --db-instance-identifier mydbinstance ^
 4.     --allocated-storage 250 ^
 5.     --db-instance-class db.t3.large ^
 6.     --vpc-security-group-ids mysecuritygroup ^
 7.     --db-subnet-group mydbsubnetgroup ^
 8.     --master-username masterawsuser ^ 
 9.     --manage-master-user-password ^
10.     --backup-retention-period 3
```
Le résultat produit lors de l’exécution de cette commande est semblable à ce qui suit :   

```
1. DBINSTANCE  mydbinstance  db.t3.large  sqlserver-se  250  sa  creating  3  ****  n  10.50.2789
2. SECGROUP  default  active
3. PARAMGRP  default.sqlserver-se-14  in-sync
```

### API RDS
<a name="USER_CreateDBInstance.API"></a>

**Note**  
Si vous souhaitez utiliser la licence DB2 via AWS Marketplace, vous devez d'abord vous abonner AWS Marketplace et vous enregistrer auprès d'IBM en utilisant le AWS Management Console. Pour de plus amples informations, veuillez consulter [Abonnement aux listes de Db2 Marketplace et inscription auprès de IBM](db2-licensing.md#db2-marketplace-subscribing-registering).

Pour créer une instance de base de données à l'aide de l'API Amazon RDS, appelez l'DBInstanceopération [Create](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html).

Pour plus d’informations sur chaque paramètre, consultez [Paramètres des instances de base de données](USER_CreateDBInstance.Settings.md). 

# Paramètres des instances de base de données
<a name="USER_CreateDBInstance.Settings"></a>

Le tableau suivant contient des détails sur les paramètres que vous choisissez lors de la création d'une instance de base de données. Le tableau répertorie également les moteurs de base de données pour lesquels chaque paramètre est pris en charge.

Vous pouvez créer une instance de base de données à l'aide de la console, de la commande [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)CLI ou de l'opération [Create DBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html) RDS API.


****  

| Paramètre de la console | Description du paramètre | Option de CLI et paramètre de l'API RDS | Moteurs de base de données pris en charge | 
| --- | --- | --- | --- | 
|  **Stockage alloué**  |  Quantité de stockage à allouer pour votre instance de base de données (en gibioctets). Dans certains cas, l'allocation d'une quantité de stockage supérieure à la taille de votre base de données pour votre instance de base de données peut améliorer les I/O performances. Pour de plus amples informations, veuillez consulter [Stockage d'instance de base de données Amazon RDS](CHAP_Storage.md).   |  **Option de l’interface CLI :** `--allocated-storage` **Paramètre de l’API :**  `AllocatedStorage`  |  Tous  | 
| Paramètres de l'architecture |  Si vous choisissez **Architecture multilocataire Oracle**, RDS for Oracle crée une base de données de conteneur (CDB). Si vous ne choisissez pas cette option, RDS for Oracle crée une base de données non-CDB. Une base de données non CDB utilise l'architecture de base de données Oracle traditionnelle. Un CDB peut contenir des bases de données enfichables (PDBs) alors qu'un non-CDB ne le peut pas. Oracle Database 21c utilise uniquement l'architecture CDB. Oracle Database 19c peut utiliser une architecture CDB ou non CDB. Les versions inférieures à Oracle Database 19c utilisent uniquement l'architecture non CDB. Pour de plus amples informations, veuillez consulter [Présentation de RDS pour Oracle CDBs](Oracle.Concepts.CDBs.md).  |  **Option de l’interface CLI :** `--engine oracle-ee-cdb` (architecture multilocataire Oracle) `--engine oracle-se2-cdb` (architecture multilocataire Oracle) `--engine oracle-ee` (traditionnel) `--engine oracle-se2` (traditionnel) **Paramètre de l’API :** `Engine`  |  Oracle  | 
| Configuration de l'architecture |  Ces paramètres ne sont valides que lorsque vous choisissez **Architecture multilocataire Oracle** pour **Paramètres d'architecture.** Choisissez l'un des paramètres supplémentaires suivants : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.Settings.html) Quelle que soit la configuration que vous choisissez, votre CDB contient une seule PDB initiale. Dans la configuration multi-locataires, vous pouvez en créer d'autres PDBs ultérieurement à l'aide de APIs RDS. Pour de plus amples informations, veuillez consulter [Présentation de RDS pour Oracle CDBs](Oracle.Concepts.CDBs.md).  |  **Option de l’interface CLI :** `--multi-tenant` (configuration à locataires multiples) `--no-multi-tenant` (configuration à locataire unique) **Paramètre de l’API :** `MultiTenant`  |  Oracle  | 
| Mise à niveau automatique de versions mineures |  Choisissez **Activer la mise à niveau automatique des versions mineures** pour permettre à votre instance de base de données de recevoir automatiquement les mises à niveau de la version mineure préférée du moteur de base de données lorsqu’elles sont disponibles. Il s’agit du comportement de par défaut. Amazon RDS effectue les mises à niveau automatiques des versions mineures dans la fenêtre de maintenance. Si vous ne choisissez pas **Activer la mise à niveau automatique des versions mineures**, votre instance de base de données n’est pas mise à niveau automatiquement lorsque de nouvelles versions mineures sont disponibles. Pour de plus amples informations, veuillez consulter [Mise à niveau automatique de la version mineure du moteur](USER_UpgradeDBInstance.Upgrading.md#USER_UpgradeDBInstance.Upgrading.AutoMinorVersionUpgrades).  |  **Option de l’interface CLI :** `--auto-minor-version-upgrade` `--no-auto-minor-version-upgrade` **Paramètre de l’API :** `AutoMinorVersionUpgrade`  | Tous | 
|  Zone de disponibilité  |  Zone de disponibilité de votre instance de base de données. Utilisez la valeur par défaut **No Preference (Aucune préférence)**, sauf si vous souhaitez spécifier une zone de disponibilité. Pour plus d'informations, consultez [Régions, zones de disponibilité et zones locales ](Concepts.RegionsAndAvailabilityZones.md).  |  **Option de l’interface CLI :** `--availability-zone` **Paramètre de l’API :** `AvailabilityZone`  | Tous | 
|   **AWS KMS key**   |  Disponible uniquement si l’option **Chiffrement** est définie sur **Activer le chiffrement**. Choisissez la AWS KMS key à utiliser pour le chiffrement de cette instance de bases de données. Pour de plus amples informations, veuillez consulter [Chiffrement des ressources Amazon RDS](Overview.Encryption.md).  |  **Option de l’interface CLI :** `--kms-key-id` **Paramètre de l’API :** `KmsKeyId`  | Tous | 
| AWS License Manager configuration |  Entrez le nom d'une configuration AWS License Manager de licence. Le nom doit comporter 100 caractères ou moins et inclure uniquement les caractères a-z, A-Z et 0-9. Pour de plus amples informations, veuillez consulter [Intégration avec AWS License Manager](db2-licensing.md#db2-lms-integration).  |  **Option de l’interface CLI :** Pour de plus amples informations, veuillez consulter [AWS License Manager CLI](db2-licensing.md#db2-lms-integration.cli). **Paramètre de l’API :** Pour de plus amples informations, veuillez consulter [AWS License Manager API](db2-licensing.md#db2-lms-integration.api).  | Db2 | 
| Réplication des sauvegardes |  Choisissez **Activer la réplication dans une autre région AWS ** pour créer des sauvegardes dans une autre région à des fins de reprise après sinistre. Sélectionnez ensuite la **Région de destination** des sauvegardes supplémentaires.  |  Non disponible lors de la création d'une instance de base de données. Pour plus d'informations sur l'activation des sauvegardes entre régions à l'aide de l'API AWS CLI ou RDS, consultez. [Activation des sauvegardes automatiques entre régions pour Amazon RDS](AutomatedBackups.Replicating.Enable.md)  |  Db2 Oracle PostgreSQL SQL Server  | 
| Période de rétention des sauvegardes  |  Nombre de jours durant lesquels les sauvegardes automatiques de votre instance de base de données doivent être conservées. Pour une instance de base de données importante, définissez cette valeur sur **1** ou une valeur supérieure. Pour plus d'informations, consultez [Présentation des sauvegardes](USER_WorkingWithAutomatedBackups.md).  |  **Option de l’interface CLI :** `--backup-retention-period` **Paramètre de l’API :** `BackupRetentionPeriod`  | Tous | 
| Cible de sauvegarde |  Choisissez **AWS Cloud**de stocker les sauvegardes automatisées et les instantanés manuels dans la AWS région parent. Choisissez **Outposts (sur site)** pour les stocker en local sur votre Outpost. Ce paramètre s'applique uniquement à RDS sur Outposts. Pour de plus amples informations, veuillez consulter [Création d'instances de base de données pour Amazon RDS sur AWS Outposts](rds-on-outposts.creating.md).  |  **Option de l’interface CLI :** `--backup-target` **Paramètre de l’API :** `BackupTarget`  | MySQL, PostgreSQL, SQL Server | 
| Fenêtre de sauvegarde |  Période de temps durant laquelle Amazon RDS effectue automatiquement une sauvegarde de votre instance de base de données. Si vous n'avez pas besoin que votre base de données soit sauvegardée à un moment précis, utilisez la valeur par défaut **No Preference (Aucune préférence)**. Pour plus d'informations, consultez [Présentation des sauvegardes](USER_WorkingWithAutomatedBackups.md).  |  **Option de l’interface CLI :** `--preferred-backup-window` **Paramètre de l’API :** `PreferredBackupWindow`  | Tous | 
|  **Autorité de certification**  |  L'autorité de certification (CA) pour le certificat de serveur utilisé par l'instance de base de données. Pour de plus amples informations, veuillez consulter [](UsingWithRDS.SSL.md).   |  **Option de l’interface CLI :** `--ca-certificate-identifier` **Paramètre de l’API RDS :** `CACertificateIdentifier`  |  Tous  | 
| Jeu de caractères |  Jeu de caractères pour l'instance de base de données. La valeur par défaut du jeu **AL32UTF8**de caractères de base de données correspond au jeu de caractères universel Unicode 5.0 UTF-8. Vous ne pouvez pas modifier le jeu de caractères de base de données après avoir créé l'instance de base de données.  Dans une configuration à locataire unique, un jeu de caractères de base de données autre que par défaut n'affecte que la base de données enfichable (PDB) et pas la base de données de conteneur (CDB). Pour plus d'informations, consultez [Configuration à locataire unique de l'architecture CDB](Oracle.Concepts.CDBs.md#Oracle.Concepts.single-tenant). Le jeu de caractères de base de données est différent du jeu de caractères national, appelé jeu de caractères NCHAR. Contrairement au jeu de caractères de base de données, le jeu de caractères NCHAR spécifie le codage des colonnes de types de données NCHAR (NCHAR, NVARCHAR2, et NCLOB) sans affecter les métadonnées de la base de données. Pour de plus amples informations, veuillez consulter [Jeux de caractères RDS for Oracle](Appendix.OracleCharacterSets.md).  |  **Option de l’interface CLI :** `--character-set-name` **Paramètre de l’API :** `CharacterSetName`  | Oracle | 
| Classement (Collation) |  Classement de niveau serveur pour votre instance de base de données. Pour plus d'informations, consultez [Classement de niveau serveur pour Microsoft SQL Server](Appendix.SQLServer.CommonDBATasks.Collation.md#Appendix.SQLServer.CommonDBATasks.Collation.Server).  |  **Option de l’interface CLI :** `--character-set-name` **Paramètre de l’API :** `CharacterSetName`  | SQL Server | 
| Copier les balises aux instantanés  |  Cette option copie les balises de l'instance de base de données dans un instantané de base de données au moment où vous créez un instantané. Pour plus d'informations, consultez [Marquage des Amazon RDS](USER_Tagging.md).   |  **Option de l’interface CLI :** `--copy-tags-to-snapshot` `--no-copy-tags-to-snapshot` **Paramètre de l’API RDS :** `CopyTagsToSnapshot`  | Tous | 
|  Authentification de base de données  |  L'option d'authentification de base de données que vous souhaitez utiliser. Choisissez **Authentification par mot de passe** pour authentifier les utilisateurs de base de données avec des mots de passe de base de données uniquement. Choisissez **Password and IAM DB authentication** (Mot de passe et authentification de base de données IAM) pour authentifier les utilisateurs de base de données avec des mots de passe de base de données et des informations d'identification utilisateur via des utilisateurs et rôles. Pour de plus amples informations, veuillez consulter [Authentification de base de données IAMpour MariaDB, MySQL et PostgreSQL](UsingWithRDS.IAMDBAuth.md). Cette option n'est prise en charge que pour MySQL et PostgreSQL. Choisissez l'**authentification par mot de passe et Kerberos** pour authentifier les utilisateurs de base de données à l'aide de mots de passe de base de données et l'authentification Kerberos via un outil créé avec. AWS Managed Microsoft AD Directory Service Ensuitez, choisissez le répertoire ou **Créer un nouveau répertoire**. Pour plus d'informations, consultez les étapes suivantes :  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.Settings.html)  |  ***IAM :*** **Option de l’interface CLI :** `--enable-iam-database-authentication` `--no-enable-iam-database-authentication` **Paramètre de l’API RDS :** `EnableIAMDatabaseAuthentication` ***Kerberos :*** **Option de l’interface CLI :** `--domain` `--domain-iam-role-name` **Paramètre de l’API RDS :** `Domain` `DomainIAMRoleName`  |  Varie selon le type d'authentification  | 
| Type de gestion de base de données |  Choisissez **Amazon RDS** si vous n'avez pas besoin de personnaliser votre environnement. Choisissez **Amazon RDS Custom** si vous souhaitez personnaliser la base de données, le système d'exploitation et l'infrastructure. Pour de plus amples informations, veuillez consulter [Amazon RDS Custom](rds-custom.md).  |  Pour l'interface de ligne de commande (CLI) et l'API, vous devez spécifier le type de moteur de base de données.  |  Oracle SQL Server  | 
|  Port de la base de données  |  Port par lequel vous souhaitez accéder à l'instance de base de données. La valeur par défaut du port est indiquée.  Dans certaines entreprises, les pare-feux bloquent les connexions aux ports MariaDB, MySQL et PostgreSQL par défaut. Si le pare-feu de votre entreprise bloque le port par défaut, entrez un autre port pour votre instance de base de données.    |  **Option de l’interface CLI :** `--port` **Paramètre de l’API RDS :** `Port`  | Tous | 
|  Version du moteur de base de données  |  Version du moteur de base de données que vous souhaitez utiliser.  |  **Option de l’interface CLI :** `--engine-version` **Paramètre de l’API RDS :** `EngineVersion`  | Tous | 
|  Classe d’instance de base de données  |  Configuration pour votre instance de base de données. Par exemple, une classe d'instance de base de données **db.t3.small** possède 2 GiB de mémoire, 2 V, 1 cœur virtuelCPUs, un ECU variable et une capacité d'E/S modérée. Dans la mesure du possible, choisissez une classe d'instance de base de données suffisamment grande pour qu'un ensemble de travail de requête classique puisse tenir dans la mémoire. Lorsque les ensembles de travail sont en mémoire, le système peut éviter d'écrire sur le disque, ce qui améliore les performances. Pour de plus amples informations, veuillez consulter [Classes d'instances de base de données ](Concepts.DBInstanceClass.md).  Dans RDS for Oracle, vous pouvez sélectionner **Include additional memory configurations (Inclure des configurations de mémoire supplémentaire)**. Ces configurations sont optimisées pour obtenir un ration mémoire-vCPU élevé. Par exemple, **db.r5.6xlarge.tpc2.mem4x** est une instance de base de données db.r5.8x dotée de 2 threads par cœur (tpc2) et de 4 fois plus de mémoire qu'une instance de base de données db.r5.6xlarge standard. Pour de plus amples informations, veuillez consulter [Classes d’instance de base de données RDS for Oracle](Oracle.Concepts.InstanceClasses.md).  |  **Option de l’interface CLI :** `--db-instance-class` **Paramètre de l’API RDS :** `DBInstanceClass`  | Tous | 
|  Identifiant d’instance de base de données  |  Nom de votre instance de base de données. Nommez vos instances de base de données de la même façon que vos serveurs sur site. L'identifiant de votre instance de base de données peut contenir jusqu'à 63 caractères alphanumériques et doit être unique pour votre compte dans la AWS région que vous avez choisie.  |  **Option de l’interface CLI :** `--db-instance-identifier` **Paramètre de l’API RDS :** `DBInstanceIdentifier`  | Tous | 
|  Groupe de paramètres de base de données  |  Groupe de paramètres pour l'instance de base de données. Vous pouvez soit choisir le groupe de paramètres par défaut, soit créer un groupe de paramètres personnalisé.  Si vous utilisez le modèle BYOL pour RDS for Db2, avant de créer une instance de base de données, vous devez d’abord créer un groupe de paramètres personnalisé contenant vos IBM Site ID et IBM Customer ID. Pour de plus amples informations, veuillez consulter [Apportez votre propre licence (BYOL) pour Db2](db2-licensing.md#db2-licensing-options-byol). Pour de plus amples informations, veuillez consulter [Groupes de paramètres pour Amazon RDS](USER_WorkingWithParamGroups.md).  |  **Option de l’interface CLI :** `--db-parameter-group-name` **Paramètre de l’API RDS :** `DBParameterGroupName`  | Tous | 
|  Groupe de sous-réseaux de base de données  | Le groupe de sous-réseaux de base de données à utiliser pour le cluster de bases de données. Sélectionnez Choose existing (Choisir existants) pour utiliser un groupe de sous-réseaux de base de données. Choisissez ensuite le groupe de sous-réseaux requis dans la liste déroulante Existing DB subnet groups (Groupes de sous-réseaux de base de données existants).Choisissez **Automatic setup** (Configuration automatique) pour permettre à RDS de sélectionner un groupe de sous-réseaux de base de données compatible. S’il n’en existe aucun, RDS crée un nouveau groupe de sous-réseaux pour votre cluster.Pour plus d’informations, consultez [Utilisation de groupes de sous-réseaux DB](USER_VPC.WorkingWithRDSInstanceinaVPC.md#USER_VPC.Subnets). |  **Option de l’interface CLI :** `--db-subnet-group-name` **Paramètre de l’API RDS :** `DBSubnetGroupName`  | Tous | 
| Volumes dédiés aux journaux |  Utilisez un volume dédié aux journaux (DLV) pour stocker les journaux de transactions de base de données sur un volume de stockage distinct du volume contenant les tables de base de données. Pour de plus amples informations, veuillez consulter [Utilisation d'un volume dédié aux journaux (DLV)](USER_PIOPS.dlv.md).  |  **Option de l’interface CLI :** `--dedicated-log-volume` **Paramètre de l’API RDS :** `DedicatedLogVolume`  | Tous | 
| Deletion protection (Protection contre la suppression) |  **Enable deletion protection (Activer la protection contre la suppression)** vise à empêcher la suppression de votre instance de base de données. Si vous créez une instance de base de données de production avec le AWS Management Console, la protection contre la suppression est activée par défaut. Pour de plus amples informations, veuillez consulter [Suppression d'une instance DB](USER_DeleteInstance.md).  |  **Option de l’interface CLI :** `--deletion-protection` `--no-deletion-protection` **Paramètre de l’API RDS :** `DeletionProtection`  | Tous | 
|  Chiffrement  |  **Activer le chiffrement** si vous souhaitez activer le chiffrement au repos pour cette instance de base de données. Pour plus d'informations, consultez [Chiffrement des ressources Amazon RDS](Overview.Encryption.md).  |  **Option de l’interface CLI :** `--storage-encrypted` `--no-storage-encrypted` **Paramètre de l’API RDS :** `StorageEncrypted`  | Tous | 
|  Surveillance améliorée  |  **Activer la surveillance améliorée** permet d’activer la collecte des métriques en temps réel pour le système d’exploitation sur lequel votre instance de base de données s’exécute. Pour plus d'informations, consultez [Surveillance des métriques du système d’exploitation à l’aide de la Surveillance améliorée](USER_Monitoring.OS.md).  |  **Options d'interface de ligne de commande :** `--monitoring-interval` `--monitoring-role-arn` **Paramètres de l'API RDS :** `MonitoringInterval` `MonitoringRoleArn`  | Tous | 
|  Engine type (Type de moteur)  |  Choisissez le nom du moteur de base de données à utiliser pour cette instance de base de données de base de données.  |  **Option de l’interface CLI :** `--engine` **Paramètre de l’API RDS :** `Engine`  | Tous | 
|  Nom de la base de données initiale  |  Nom de la base de données dans votre instance de base de données. Si vous ne fournissez pas de nom, Amazon RDS ne crée pas de base de données sur l'instance de base de données (sauf pour Oracle et PostgreSQL). Le nom ne peut pas être un mot réservé par le moteur de base de données et possède d'autres contraintes selon le moteur de base de données. Db2 :  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.Settings.html) MariaDB et MySQL : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.Settings.html) Oracle : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.Settings.html) PostgreSQL : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.Settings.html)  |  **Option de l’interface CLI :** `--db-name` **Paramètre de l’API RDS :** `DBName`  | Tous sauf SQL Server | 
|  Licence |  Valeurs valides pour le modèle de licence : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.Settings.html)  |  **Option de l’interface CLI :** `--license-model` **Paramètre de l’API RDS :** `LicenseModel`  |  Tous  | 
|  **Exportations des journaux**  |  Les types de fichiers journaux de base de données à publier sur Amazon CloudWatch Logs.  Pour de plus amples informations, veuillez consulter [Publication des journaux de base de données dans Amazon CloudWatch Logs](USER_LogAccess.Procedural.UploadtoCloudWatch.md).   |  **Option de l’interface CLI :** `--enable-cloudwatch-logs-exports` **Paramètre de l’API RDS :** `EnableCloudwatchLogsExports`  |  Tous  | 
|  Fenêtre de maintenance  |  Créneau de 30 minutes pendant lequel les modifications en attente pour votre instance de base de données sont appliquées. Si la période n'a pas d'importance, choisissez **No Preference (Aucune préférence)**. Pour plus d'informations, consultez [Fenêtre de maintenance Amazon RDS](USER_UpgradeDBInstance.Maintenance.md#Concepts.DBMaintenance).  |  **Option de l’interface CLI :** `--preferred-maintenance-window` **Paramètre de l’API RDS :** `PreferredMaintenanceWindow`  | Tous | 
|  Gérez les informations d'identification principales dans AWS Secrets Manager  |  Sélectionnez **Gérer les informations d’identification principales dans AWS Secrets Manager** pour gérer le mot de passe d’utilisateur principal dans un secret, dans Secrets Manager. Vous pouvez éventuellement choisir une clé KMS à utiliser pour protéger le secret. Choisissez l’une des clés KMS de votre compte ou entrez la clé d’un autre compte. Pour plus d’informations, consultez [Gestion des mots de passe avec Amazon RDS, et AWS Secrets Manager](rds-secrets-manager.md).  |  **Option de l’interface CLI :** `--manage-master-user-password \| --no-manage-master-user-password` `--master-user-secret-kms-key-id` **Paramètre de l’API RDS :** `ManageMasterUserPassword` `MasterUserSecretKmsKeyId`  | Tous | 
|  Mot de passe principal  |  Mot de passe de votre compte utilisateur principal. Le mot de passe comporte le nombre suivant de caractères ASCII imprimables (à l'exclusion des caractères `/`, `"`, espace et `@`) selon le moteur de base de données : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.Settings.html)  |  **Option de l’interface CLI :** `--master-user-password` **Paramètre de l’API RDS :** `MasterUserPassword`  | Tous | 
|  Identifiant principal  |  Nom que vous utilisez comme nom d'utilisateur principal pour vous connecter à votre instance de base de données avec tous les privilèges de base de données. Notez les restrictions d'attribution de noms suivantes : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.Settings.html) Vous ne pouvez pas changer le nom d'utilisateur principal après la création de l'instance de base de données. Pour Db2, nous vous recommandons d’utiliser le même nom d’utilisateur principal que le nom de votre instance Db2 autogérée. Pour en savoir plus sur les privilèges accordés à l'utilisateur principal, consultez [Privilèges du compte utilisateur principal](UsingWithRDS.MasterAccounts.md).  |  **Option de l’interface CLI :** `--master-username` **Paramètre de l’API RDS :** `MasterUsername`  | Tous | 
| Authentification Windows Microsoft SQL Server |  **Activez l'authentification Windows pour Microsoft SQL Server**, puis **parcourez le répertoire** pour choisir le répertoire dans lequel vous souhaitez permettre aux utilisateurs de domaine autorisés de s'authentifier auprès de cette instance SQL Server à l'aide de l'authentification Windows.  |  **Options d'interface de ligne de commande :** `--domain` `--domain-iam-role-name` **Paramètres de l'API RDS :** `Domain`  `DomainIAMRoleName`  |  SQL Server  | 
|  déploiement multi-AZ  |  **Create a standby instance (Créer une instance de secours)** permet de créer un réplica secondaire passif de votre instance de base de données dans une autre zone de disponibilité pour la prise en charge du basculement. Nous recommandons Multi-AZ pour les charges de travail de production afin de maintenir une haute disponibilité. Pour le développement et les tests, vous pouvez choisir **Do not create a standby instance (Ne pas créer d'instance de secours)**. Pour plus d'informations, consultez [Configuration et gestion d’un déploiement multi-AZ pour Amazon RDS](Concepts.MultiAZ.md).  |  **Option de l’interface CLI :** `--multi-az` `--no-multi-az` **Paramètre de l’API RDS :** `MultiAZ`  | Tous | 
| Jeu de caractères national (NCHAR) |  Jeu de caractères national pour votre instance de base de données, communément appelé jeu de caractères NCHAR. Vous pouvez définir le jeu de caractères national sur AL16 UTF16 (par défaut) ou sur UTF-8. Vous ne pouvez pas modifier le jeu de caractères national après avoir créé l'instance de base de données.  Le jeu de caractères national est différent du jeu de caractères de base de données. Contrairement au jeu de caractères de base de données, le jeu de caractères national spécifie le codage uniquement pour les colonnes de types de données NCHAR (NCHAR, NVARCHAR2, et NCLOB) sans affecter les métadonnées de la base de données. Pour de plus amples informations, veuillez consulter [Jeux de caractères RDS for Oracle](Appendix.OracleCharacterSets.md).  |  **Option de l’interface CLI :** `--nchar-character-set-name` **Paramètre de l’API :** `NcharCharacterSetName`  | Oracle | 
|  Network type (Type de réseau)  |  Les protocoles d'adressage IP pris en charge par l'instance de la base de données. **IPv4**(valeur par défaut) pour spécifier que les ressources peuvent communiquer avec l'instance de base de données uniquement via le protocole d'adressage Internet Protocol version 4 (IPv4). **Mode double pile** pour spécifier que les ressources peuvent communiquer avec l'instance de base de données via IPv4 le protocole Internet version 6 (IPv6) ou les deux. Utilisez le mode double pile si vous avez des ressources qui doivent communiquer avec votre instance de base de données via le protocole d' IPv6 adressage. Assurez-vous également d'associer un bloc IPv6 CIDR à tous les sous-réseaux du groupe de sous-réseaux de base de données que vous spécifiez. Pour de plus amples informations, veuillez consulter [Adressage IP Amazon RDS](USER_VPC.WorkingWithRDSInstanceinaVPC.md#USER_VPC.IP_addressing).  |  **Option de l’interface CLI :** `--network-type` **Paramètre de l’API RDS :** `NetworkType`  |  Tous  | 
|  Groupe d'options  |  Groupe d'options pour l'instance de base de données. Vous pouvez choisir le groupe d'options par défaut, ou vous pouvez créer un groupe d'options personnalisé. Pour plus d'informations, consultez [Utilisation de groupes d’options](USER_WorkingWithOptionGroups.md).  |  **Option de l’interface CLI :** `--option-group-name` **Paramètre de l’API RDS :** `OptionGroupName`  |  Tous  | 
| Performance Insights |  **Activer Performance Insights** permet de surveiller la charge de votre instance de base de données et ainsi d'analyser les performances de votre base de données et de résoudre les problèmes associés. Choisissez une période de conservation pour déterminer l'historique des données de Performance Insights à conserver. Le paramètre de conservation est **Par défaut (7 jours)**. Pour conserver vos données de performance plus longtemps, indiquez 1 à 24 mois. Pour obtenir plus d'informations sur les périodes de conservation, consultez [Tarification et conservation des données pour Performance Insights](USER_PerfInsights.Overview.cost.md). Choisissez la clé KMS à utiliser pour protéger la clé servant à chiffrer ce volume de base de données. Choisissez l'une des clés KMS de votre compte ou entrez la clé d'un autre compte. Pour plus d’informations, consultez [Surveillance de la charge de la base de données avec Performance Insights sur Amazon RDS](USER_PerfInsights.md).  |  **Options d'interface de ligne de commande :** `--enable-performance-insights` `--no-enable-performance-insights` `--performance-insights-retention-period` `--performance-insights-kms-key-id` **Paramètres de l'API RDS :** `EnablePerformanceInsights` `PerformanceInsightsRetentionPeriod` `PerformanceInsightsKMSKeyId`  | Tous sauf Db2 | 
|  **IOPS provisionnés**  |  Valeur d'IOPS provisionnés (opérations d'I/O par seconde) pour l'instance de base de données. Ce paramètre n'est disponible que si vous choisissez l'une des options suivantes pour **Storage type** (Type de stockage) : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.Settings.html) Pour de plus amples informations, veuillez consulter [Stockage d'instance de base de données Amazon RDS](CHAP_Storage.md).  |  **Option de l’interface CLI :** `--iops` **Paramètre de l’API RDS :** `Iops`  |  Tous  | 
|  Accès public  |  La valeur **Oui** dote l'instance de base de données d'une adresse IP publique, ce qui signifie qu'elle est accessible en dehors du VPC. Pour être accessible au public, l’instance de base de données doit aussi se trouver dans un sous-réseau public du VPC. La valeur **Non** rend l'instance de base de données accessible uniquement au sein du VPC. Pour de plus amples informations, veuillez consulter [Masquer une instance de base de données dans un VPC depuis Internet](USER_VPC.WorkingWithRDSInstanceinaVPC.md#USER_VPC.Hiding). Pour se connecter à une instance de base de données depuis l'extérieur de son VPC, l'instance de base de données doit être accessible publiquement. En outre, l'accès doit être accordé en utilisant les règles entrantes du groupe de sécurité de l'instance de base de données. En outre, d'autres exigences doivent être respectées. Pour de plus amples informations, veuillez consulter [Impossible de se connecter à l’instance de base de données Amazon RDS](CHAP_Troubleshooting.md#CHAP_Troubleshooting.Connecting). Si votre instance de base de données n'est pas accessible au public, utilisez une connexion AWS Site-to-Site VPN ou une Direct Connect connexion pour y accéder depuis un réseau privé. Pour de plus amples informations, veuillez consulter [Confidentialité du trafic inter-réseau](inter-network-traffic-privacy.md).  |  **Option de l’interface CLI :** `--publicly-accessible` `--no-publicly-accessible` **Paramètre de l’API RDS :** `PubliclyAccessible`  | Tous | 
| Support étendu RDS |  Sélectionnez **Activer le support étendu RDS** pour permettre aux versions majeures du moteur prises en charge de continuer à fonctionner après la date de fin du support standard RDS. Lorsque vous créez une instance de bases de données, Amazon RDS utilise par défaut le support étendu RDS. Pour empêcher la création d’une nouvelle instance de base de données après la date de fin du support standard RDS et pour éviter les frais liés au support étendu RDS, désactivez ce paramètre. Vos instances de base de données existantes ne seront pas facturées avant la date de début des tarifs du support étendu RDS. Pour de plus amples informations, veuillez consulter [Support étendu Amazon RDS avec Amazon RDS](extended-support.md). |  **Option de l’interface CLI :** `--engine-lifecycle-support` **Paramètre de l’API RDS :** `EngineLifecycleSupport`  |  MySQL PostgreSQL  | 
|  **RDS Proxy** (Proxy RDS)  |  Choisissez **Create an RDS Proxy** (Créer un proxy RDS) pour créer un proxy pour votre instance de base de données. Amazon RDS crée automatiquement un rôle IAM et un secret Secrets Manager pour le proxy. Pour de plus amples informations, veuillez consulter [Proxy Amazon RDS ](rds-proxy.md).   |  Non disponible lors de la création d'une instance de base de données.  |  MariaDB MySQL PostgreSQL  | 
|  Dimensionnement automatique du stockage  |  **Enable storage autoscaling (Activer le dimensionnement automatique du stockage)** permet à Amazon RDS d'augmenter automatiquement l'espace de stockage quand cela est nécessaire pour éviter que votre instance de base de données en manque. Utilisez **Maximum storage threshold (Seuil de stockage maximum)** pour définir la limite supérieure au-delà de laquelle Amazon RDS augmente automatiquement l'espace de stockage pour votre instance de base de données. La valeur par défaut est 1 000 Gio. Pour plus d'informations, consultez [Gestion automatique de la capacité avec le dimensionnement automatique du stockage Amazon RDS](USER_PIOPS.Autoscaling.md).   |  **Option de l’interface CLI :** `--max-allocated-storage` **Paramètre de l’API RDS :** `MaxAllocatedStorage`  | Tous | 
|  **Storage throughput** (Débit de stockage)  |  La valeur de débit de stockage de l'instance de base de données. Ce paramètre n'est disponible que si vous choisissez **General purpose SSD (gp3)** (SSD à usage général (gp3)) pour **Storage type** (Type de stockage). Pour de plus amples informations, veuillez consulter [Stockage gp3 (recommandé)](CHAP_Storage.md#gp3-storage).  |  **Option de l’interface CLI :** `--storage-throughput` **Paramètre de l’API RDS :** `StorageThroughput`  | Tous | 
|  Type de stockage  |  Type de stockage pour votre instance de base de données. Si vous choisissez **General Purpose SSD (gp3)** (SSD à usage général (gp3)), vous pouvez allouer des IOPS provisionnés et un débit de stockage supplémentaires sous **Advanced settings** (Paramètres avancés). Si vous choisissez **SSD à IOPS provisionnées (io1)** ou **SSD à IOPS provisionnées (io2)**, entrez la valeur **IOPS provisionnées**. Pour de plus amples informations, veuillez consulter [Types de stockage Amazon RDS](CHAP_Storage.md#Concepts.Storage).  |  **Option de l’interface CLI :** `--storage-type` **Paramètre de l’API RDS :** `StorageType`  | Tous | 
| Volumes de stockage supplémentaires  |  Vous pouvez ajouter jusqu'à trois volumes de stockage supplémentaires à votre instance de base de données RDS pour Oracle ou RDS pour SQL Server. Vous pouvez configurer chaque volume supplémentaire pour utiliser les types de stockage gp3 ou io2. Vous pouvez également spécifier différents paramètres de stockage alloué, d'IOPS et de débit afin d'optimiser les exigences de votre charge de travail. Assurez-vous de spécifier les noms des volumes sous la forme `rdsdbdata2``rdsdbdata3`, ou`rdsdbdata4`. Le stockage combiné entre le volume principal et le volume supplémentaire ne peut pas dépasser 256 TiB.  |  **Option de l’interface CLI :** `--additional-storage-volumes` **Paramètre de l’API RDS :** `AdditionalStorageVolumes`  | Oracle et SQL Server | 
| Groupe de sous-réseaux  |  Groupe de sous-réseaux de base de données à associer à cette instance de base de données. Pour de plus amples informations, veuillez consulter [Utilisation de groupes de sous-réseaux DB](USER_VPC.WorkingWithRDSInstanceinaVPC.md#USER_VPC.Subnets).  |  **Option de l’interface CLI :** `--db-subnet-group-name` **Paramètre de l’API RDS :** `DBSubnetGroupName`  | Tous | 
| Nom de la base de données locataire |  Le nom de votre PDB initiale dans la configuration à locataires multiples de l'architecture Oracle. Ce paramètre n'est disponible que si vous choisissez **Configuration à locataires multiples** pour **Configuration de l'architecture**.  Le nom de la base de données locataire doit être différent de celui de votre CDB, à savoir `RDSCDB`. Vous ne pouvez pas changer le nom de la CDB.  |  **Option de l’interface CLI :** `--db-name` **Paramètre de l’API RDS :** `DBName`  |  Oracle  | 
| Nom d'utilisateur principal de la base de données locataire |  Le nom que vous utilisez comme nom d'utilisateur principal pour vous connecter à votre base de données locataire (PDB) avec tous les privilèges de base de données. Ce paramètre n'est disponible que si vous choisissez **Configuration à locataires multiples** pour **Configuration de l'architecture**.  Notez les restrictions d'attribution de noms suivantes : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.Settings.html) Vous ne pouvez pas exécuter les actions suivantes : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.Settings.html)  |  **Option de l’interface CLI :** `--master-username` **Paramètre de l’API RDS :** `MasterUsername`  |  Oracle  | 
| Mot de passe principal de base de données locataire |  Le mot de passe du compte d'utilisateur principal de votre base de données locataire (PDB). Ce paramètre n'est disponible que si vous choisissez **Configuration à locataires multiples** pour **Configuration de l'architecture**. Le mot de passe comporte de 8 à 30 caractères ASCII imprimables, à l'exception de `/`, de `"`, d'un espace et de `@`.  |  **Option de l’interface CLI :** `--master-password` **Paramètre de l’API RDS :** `MasterPassword`  |  Oracle  | 
| Jeu de caractères de base de données locataire |  Le jeu de caractères de la base de données locataire initiale. Ce paramètre n'est disponible que si vous choisissez **Configuration à locataires multiples** pour **Configuration de l'architecture**. Seules les instances de CDB RDS for Oracle sont prises en charge. La valeur par défaut du jeu **AL32UTF8**de caractères de la base de données mutualisée correspond au jeu de caractères universel Unicode 5.0 UTF-8. Vous pouvez choisir un jeu de caractères de base de données locataire différent du jeu de caractères de la CDB. Pour de plus amples informations, veuillez consulter [Jeux de caractères RDS for Oracle](Appendix.OracleCharacterSets.md).  |  **Option de l’interface CLI :** `--character-set-name` **Paramètre de l’API RDS :** `CharacterSetName`  |  Oracle  | 
| Jeu de caractères national de base de données locataire |  Jeu de caractères national pour votre base de données locataire, communément appelé jeu de caractères `NCHAR`. Ce paramètre n'est disponible que si vous choisissez **Configuration à locataires multiples** pour **Configuration de l'architecture**. Seules les instances de CDB RDS for Oracle sont prises en charge. Vous pouvez définir le jeu de caractères national sur **AL16UTF16**(par défaut) ou sur **UTF-8**. Vous ne pouvez pas modifier le jeu de caractères national après la création de la base de données locataire.  Le jeu de caractères national de base de données locataire est différent du jeu de caractères de la base de données locataire. Le jeu de caractères national spécifie l'encodage uniquement pour les colonnes qui utilisent le type de données `NCHAR` (`NCHAR`, `NVARCHAR2` et `NCLOB`) et n'affecte pas les métadonnées de la base de données. Pour de plus amples informations, veuillez consulter [Jeux de caractères RDS for Oracle](Appendix.OracleCharacterSets.md).  |  **Option de l’interface CLI :** `--nchar-character-set-name` **Paramètre de l’API :** `NcharCharacterSetName`  |  Oracle  | 
|  Fuseau horaire  |  Fuseau horaire de votre instance de base de données. Si vous ne choisissez pas de fuseau horaire, votre instance de base de données utilise le fuseau horaire par défaut. Vous ne pouvez pas modifier le fuseau horaire après la création de l'instance de base de données. Pour plus d’informations, consultez [Fuseau horaire local pour les instances de base de données Amazon RDS for Db2](db2-time-zone.md) et [Fuseau horaire local pour les instances de bases de données Microsoft SQL Server](SQLServer.Concepts.General.TimeZone.md).  |  **Option de l’interface CLI :** `--timezone` **Paramètre de l’API RDS :** `Timezone`  |  Db2 SQL Server RDS Custom for SQL Server  | 
|  Cloud privé virtuel (VPC)  |  Un VPC basé sur le service Amazon VPC à associer à cette instance de base de données. Pour de plus amples informations, veuillez consulter [Amazon VPC et Amazon RDS](USER_VPC.md).  |  Pour la CLI et l'API, vous spécifiez le groupe de sécurité VPC. IDs  | Tous | 
|  VPC security group (firewall) [Groupe de sécurité VPC (pare-feu)]  |  Groupe de sécurité à associer à l'instance de base de données. Pour de plus amples informations, veuillez consulter [Présentation des groupes de sécurité VPC](Overview.RDSSecurityGroups.md#Overview.RDSSecurityGroups.VPCSec).  |  **Option de l’interface CLI :** `--vpc-security-group-ids` **Paramètre de l’API RDS :** `VpcSecurityGroupIds`  | Tous | 

# Création de ressources Amazon RDS () avec AWS CloudFormation
<a name="creating-resources-with-cloudformation"></a>

Amazon RDS est intégré à AWS CloudFormation un service qui vous aide à modéliser et à configurer vos AWS ressources afin que vous puissiez passer moins de temps à créer et à gérer vos ressources et votre infrastructure. Vous créez un modèle qui décrit toutes les AWS ressources souhaitées (telles que les instances de base de données et les groupes de paramètres de base de données) puis vous CloudFormation provisionnez et configurez ces ressources pour vous. 

Lorsque vous l'utilisez CloudFormation, vous pouvez réutiliser votre modèle pour configurer vos ressources RDS de manière cohérente et répétée. Décrivez vos ressources une seule fois, puis fournissez les mêmes ressources à plusieurs reprises dans plusieurs AWS comptes et régions. 

## RDS et modèles CloudFormation
<a name="working-with-templates"></a>

CloudFormation les [modèles](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-guide.html) sont des fichiers texte formatés en JSON ou YAML. Ces modèles décrivent les ressources que vous souhaitez mettre à disposition dans vos CloudFormation piles. Si vous n'êtes pas familiarisé avec JSON ou YAML, vous pouvez utiliser CloudFormation Designer pour vous aider à démarrer avec les CloudFormation modèles. Pour plus d’informations, consultez [Qu’est-ce que CloudFormation Designer](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/working-with-templates-cfn-designer.html) dans le *Guide de l’utilisateur AWS CloudFormation *.

RDS prend en charge la création de ressources dans. CloudFormation Pour plus d’informations, y compris des exemples de modèles JSON et YAML pour ces ressources, consultez la [Référence de type de ressource RDS](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_RDS.html) dans le *Guide de l’utilisateur AWS CloudFormation *.

## En savoir plus sur CloudFormation
<a name="learn-more-cloudformation"></a>

Pour en savoir plus CloudFormation, consultez les ressources suivantes :
+ [AWS CloudFormation](https://aws.amazon.com/cloudformation/)
+ [AWS CloudFormation Guide de l'utilisateur](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)
+ [CloudFormation API Reference](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/Welcome.html)
+ [AWS CloudFormation Guide de l'utilisateur de l'interface de ligne de commande](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/what-is-cloudformation-cli.html)

# Connexion à une instance de base de données Amazon RDS
<a name="CHAP_CommonTasks.Connect"></a>

 Avant de pouvoir vous connecter à une instance de base de données, vous devez créer l'instance de base de données. Pour plus d'informations, consultez [Création d'une instance de base de données Amazon RDS](USER_CreateDBInstance.md). Une fois qu'Amazon RDS a provisionné votre instance de base de données, utilisez n'importe quelle application client standard ou utilitaire pour votre moteur de base de données pour vous connecter à l'instance de base de données. Dans la chaîne de connexion, spécifiez l'adresse DNS du point de terminaison de l'instance de base de données comme paramètre d'hôte. Vous spécifiez également le numéro de port du point de terminaison de l'instance de base de données en tant que paramètre de port. 

Pour plus d’informations sur la recherche d’informations de connexion pour une instance de base de données Amazon RDS ou sur les scénarios d’accès à une instance de base de données dans un VPC, consultez les rubriques suivantes.
+ [Recherche des informations de connexion pour une instance de base de données Amazon RDS](CHAP_CommonTasks.Connect.EndpointAndPort.md)
+ [Scénarios d'accès à une instance de base de données d'un VPC](CHAP_CommonTasks.Connect.ScenariosForAccess.md)

# Recherche des informations de connexion pour une instance de base de données Amazon RDS
<a name="CHAP_CommonTasks.Connect.EndpointAndPort"></a>

Les informations de connexion d'une instance de base de données incluent son point de terminaison, son port et un utilisateur de base de données valide, tel que l'utilisateur principal. Par exemple, pour une instance de base de données MySQL, supposons que la valeur du point de terminaison est `mydb.123456789012.us-east-1.rds.amazonaws.com`. Dans ce cas, la valeur du port est `3306`, et l'utilisateur de base de données est `admin`. Compte tenu de ces informations, vous spécifiez les valeurs suivantes dans une chaîne de connexion :
+ Pour un hôte, un nom d'hôte ou un nom DNS, spécifiez `mydb.123456789012.us-east-1.rds.amazonaws.com`.
+ Pour un port, spécifiez `3306`.
+ Pour l'utilisateur, spécifiez `admin`.

Le point de terminaison est unique pour chaque instance de base de données, et les valeurs du port et de l'utilisateur peuvent varier. La liste suivante présente le port le plus courant pour chaque moteur de base de données :
+ Db2 – 50 000
+ MariaDB – 3306
+ Microsoft SQL Server – 1433
+ MySQL – 3306
+ Oracle – 1521
+ PostgreSQL – 5432

Pour vous connecter à une instance de base de données, utilisez n'importe quel client pour un moteur de base de données. Par exemple, vous pouvez utiliser l'utilitaire mysql pour vous connecter à une instance de base de données MariaDB ou MySQL. Vous pouvez utiliser Microsoft SQL Server Management Studio pour vous connecter à une instance de base de données SQL Server. Vous pouvez utiliser Oracle SQL Developer pour vous connecter à une instance de bases de données Oracle. Vous pouvez également utiliser un utilitaire de ligne de commande psql pour vous connecter à une instance de base de données PostgreSQL.

Pour rechercher les informations de connexion d'une instance de base de données, utilisez la AWS Management Console. Vous pouvez également utiliser la commande AWS Command Line Interface (AWS CLI) [describe-db-instances](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html) ou l'opération d'API RDS [DescribeDBInstances](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBInstances.html). 

## Console
<a name="CHAP_CommonTasks.Connect.EndpointAndPort.Console"></a>

**Pour rechercher les informations de connexion d’une instance de base de données dans la AWS Management Console**

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** pour afficher la liste de vos instances de base de données.

1. Choisissez le nom de l'instance de base de données pour afficher ses détails.

1. Dans l’onglet **Connectivity & security (Connectivité et sécurité)**, copiez le point de terminaison. Notez également le numéro du port. Vous avez besoin du point de terminaison et du numéro de port pour vous connecter à l’instance de base de données.   
![\[Point de terminaison et port d'une instance de base de données\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/endpoint-port.png)

1. Si vous devez rechercher le nom d'utilisateur principal, choisissez l'onglet **Configuration** et affichez la valeur **Master username (Identifiant principal**.

## AWS CLI
<a name="CHAP_CommonTasks.Connect.EndpointAndPort.CLI"></a>

Pour rechercher les informations de connexion d'une instance de base de données à l'aide de AWS CLI, appelez la commande [describe-db-instances](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html). Dans l’appel, recherchez l’ID d’instance de base de données, le point de terminaison, le port et l’identifiant principal.

Pour Linux, macOS ou Unix :

```
aws rds describe-db-instances \
  --query "*[].[DBInstanceIdentifier,Endpoint.Address,Endpoint.Port,MasterUsername]"
```

Pour Windows :

```
aws rds describe-db-instances ^
  --query "*[].[DBInstanceIdentifier,Endpoint.Address,Endpoint.Port,MasterUsername]"
```

Votre sortie doit ressembler à ce qui suit.

```
[
    [
        "mydb",
        "mydb.123456789012.us-east-1.rds.amazonaws.com",
        3306,
        "admin"
    ],
    [
        "myoracledb",
        "myoracledb.123456789012.us-east-1.rds.amazonaws.com",
        1521,
        "dbadmin"
    ],
    [
        "mypostgresqldb",
        "mypostgresqldb.123456789012.us-east-1.rds.amazonaws.com",
        5432,
        "postgresadmin"
    ]
]
```

## API RDS
<a name="CHAP_CommonTasks.Connect.EndpointAndPort.API"></a>

Pour rechercher les informations de connexion d'une instance de base de données à l'aide de l'API Amazon RDS, appelez l'opération [DescribedBInstances](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBInstances.html). Dans la sortie, recherchez les valeurs de l’adresse du point de terminaison, du port du point de terminaison et du nom d’utilisateur principal. 

# Scénarios d'accès à une instance de base de données d'un VPC
<a name="CHAP_CommonTasks.Connect.ScenariosForAccess"></a>

Amazon Virtual Private Cloud (Amazon VPC) vous permet de lancer des ressources AWS, telles que des instances de base de données Amazon RDS, dans un cloud privé virtuel (VPC). Lorsque vous utilisez Amazon VPC, vous disposez d'un contrôle total sur l'environnement de réseau virtuel. Vous pouvez choisir votre propre plage d'adresses IP, créer des sous-réseaux et configurer le routage et les listes de contrôle d'accès.

Un groupe de sécurité du VPC contrôle l'accès aux instances de base de données dans un VPC. Chaque règle de groupe de sécurité VPC permet à une source spécifique d'accéder à une instance de base de données dans un VPC associée à ce groupe de sécurité VPC. Cette source peut être une plage d'adresses (par exemple, 203.0.113.0/24) ou un autre groupe de sécurité VPC. En spécifiant un groupe de sécurité VPC en tant que source, vous autorisez le trafic entrant provenant de toutes les instances (généralement les serveurs d'application) qui utilisent le groupe de sécurité VPC source.

Avant de tenter de vous connecter à votre instance de base de données, configurez votre VPC pour votre cas d'utilisation. Les scénarios suivants sont courants pour accéder à une instance de base de données dans un VPC : 
+ **Une instance de base de données dans un VPC accessible par une instance Amazon EC2 dans le même VPC** – Une utilisation courante d'une instance de base de données d'un VPC consiste à partager les données avec un serveur d'application qui s'exécute dans une instance EC2 du même VPC. L'instance EC2 peut exécuter un serveur web avec une application qui interagit avec l'instance de base de données.
+ **Une instance de base de données d'un VPC accédée par une instance EC2 d'un autre VPC** – Dans certains cas, votre instance de base de données se trouve dans un VPC différent de l'instance EC2 que vous utilisez pour y accéder. Si tel est le cas, vous pouvez utiliser l'appairage VPC pour accéder à l'instance de base de données. 
+ **Une instance de base de données d'un VPC accessible par une application cliente via Internet** – Pour accéder à une instance de base de données d'un VPC à partir d'une application cliente via Internet, vous configurez un VPC avec un seul sous-réseau public. Vous configurez également une passerelle Internet pour permettre la communication via Internet. 

  Pour se connecter à une instance de base de données depuis l'extérieur de son VPC, l'instance de base de données doit être accessible publiquement. En outre, l'accès doit être accordé en utilisant les règles entrantes du groupe de sécurité de l'instance de base de données, et d'autres exigences doivent être satisfaites. Pour de plus amples informations, consultez [Impossible de se connecter à l’instance de base de données Amazon RDS](CHAP_Troubleshooting.md#CHAP_Troubleshooting.Connecting).
+ **Une instance de base de données dans un VPC accessible par un réseau privé** – Si votre instance de base de données n'est pas accessible au public, vous pouvez utiliser l'une des options suivantes pour y accéder depuis un réseau privé :
  + Une connexion AWS Site-to-Site VPN
  + Une connexion Direct Connect
  + Une connexion AWS Client VPN

Pour de plus amples informations, consultez [Scénarios d’accès à une instance de base de données d’un VPC](USER_VPC.Scenarios.md).

## Connexion aux instances de base de données avec les AWS pilotes
<a name="RDS.Connecting.Drivers"></a>

La AWS suite de pilotes a été conçue pour accélérer les temps de basculement et de basculement, ainsi que pour l'authentification avec AWS Secrets Manager, Gestion des identités et des accès AWS (IAM) et l'identité fédérée. Les AWS pilotes s'appuient sur la surveillance de l'état de l'instance de base de données et sur la connaissance de la topologie de l'instance pour déterminer la nouvelle instance principale. Cette approche réduit les temps de bascule et de basculement à moins de 10 secondes, contre des dizaines de secondes pour les pilotes open source.

Le tableau suivant répertorie les fonctionnalités prises en charge pour tous les pilotes. À mesure que de nouvelles fonctionnalités de service sont introduites, l'objectif de la AWS suite de pilotes est de fournir un support intégré pour ces fonctionnalités de service.


| Fonctionnalité | [AWS Pilote JDBC](https://github.com/awslabs/aws-advanced-jdbc-wrapper) | [AWS Pilote Python](https://github.com/awslabs/aws-advanced-python-wrapper) | [AWS Pilote ODBC pour MySQL](https://github.com/aws/aws-mysql-odbc) | 
| --- | --- | --- | --- | 
| Prise en charge du basculement | [Oui](https://github.com/awslabs/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/using-plugins/UsingTheFailoverPlugin.md) | [Oui](https://github.com/awslabs/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheFailoverPlugin.md) | [Oui](https://github.com/aws/aws-mysql-odbc/blob/main/docs/using-the-aws-driver/UsingTheAwsDriver.md#failover-process) | 
| Surveillance améliorée du basculement | [Oui](https://github.com/awslabs/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/using-plugins/UsingTheHostMonitoringPlugin.md) | [Oui](https://github.com/awslabs/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheHostMonitoringPlugin.md) | [Oui](https://github.com/aws/aws-mysql-odbc/blob/main/docs/using-the-aws-driver/HostMonitoring.md#enhanced-failure-monitoring) | 
| Répartition lecture/écriture | [Oui](https://github.com/awslabs/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/using-plugins/UsingTheReadWriteSplittingPlugin.md) | [Oui](https://github.com/awslabs/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheReadWriteSplittingPlugin.md) | Non | 
| Connexion aux métadonnées du pilote | [Oui](https://github.com/awslabs/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/using-plugins/UsingTheDriverMetadataConnectionPlugin.md) | N/A | N/A | 
| Télémétrie | [Oui](https://github.com/awslabs/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/Telemetry.md) | [Oui](https://github.com/aws/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/Telemetry.md) | Non | 
| Secrets Manager | [Oui](https://github.com/awslabs/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/using-plugins/UsingTheAwsSecretsManagerPlugin.md) | [Oui](https://github.com/awslabs/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheAwsSecretsManagerPlugin.md) | [Oui](https://github.com/aws/aws-mysql-odbc/blob/main/docs/using-the-aws-driver/UsingTheAwsDriver.md#secrets-manager-authentication) | 
| Authentification IAM | [Oui](https://github.com/awslabs/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/using-plugins/UsingTheIamAuthenticationPlugin.md) | [Oui](https://github.com/awslabs/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheIamAuthenticationPlugin.md) | [Oui](https://github.com/aws/aws-mysql-odbc/blob/main/docs/using-the-aws-driver/UsingTheAwsDriver.md#iam-authentication) | 
| Identité fédérée (AD FS) | [Oui](https://github.com/awslabs/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/using-plugins/UsingTheFederatedAuthPlugin.md) | [Oui](https://github.com/awslabs/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheFederatedAuthenticationPlugin.md) | Non | 
| Identité fédérée (Okta) | [Oui](https://github.com/awslabs/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/using-plugins/UsingTheFederatedAuthPlugin.md) | Non | Non | 
| Clusters de bases de données multi-AZ | [Oui](https://github.com/awslabs/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/SupportForRDSMultiAzDBCluster.md) | [Oui](https://github.com/aws/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/SupportForRDSMultiAzDBCluster.md) | Non | 

Pour plus d'informations sur les AWS pilotes, consultez le pilote de langue correspondant à votre instance de base de données [RDS pour MariaDB](MariaDB.Connecting.Drivers.md#MariaDB.Connecting.JDBCDriver), [RDS pour MySQL ou [RDS](PostgreSQL.Connecting.JDBCDriver.md) pour PostgreSQL](MySQL.Connecting.Drivers.md#MySQL.Connecting.JDBCDriver).

**Note**  
Les seules fonctionnalités prises en charge par RDS pour MariaDB sont l'authentification AWS Secrets Manager avec Gestion des identités et des accès AWS , (IAM) et l'identité fédérée.

## Connexion à une instance de base de données qui exécute un moteur de base de données spécifique
<a name="CHAP_CommonTasks.Connect.DBEngine"></a>

Pour savoir comment vous connecter à une instance de base de données qui exécute un moteur de base de données spécifique, suivez les instructions relatives à votre moteur de base de données :
+ [RDS for Db2](USER_ConnectToDb2DBInstance.md)
+ [RDS for MariaDB](USER_ConnectToMariaDBInstance.md)
+ [RDS for SQL Server](USER_ConnectToMicrosoftSQLServerInstance.md)
+ [RDS for MySQL](USER_ConnectToInstance.md)
+ [RDS for Oracle](USER_ConnectToOracleInstance.md)
+ [RDS pour PostgreSQL](USER_ConnectToPostgreSQLInstance.md)

## Gestion des connexions avec RDS Proxy
<a name="CHAP_CommonTasks.Connect.RDSProxy"></a>

Vous pouvez également utiliser Proxy Amazon RDS pour gérer les connexions aux instances de base de données RDS for MariaDB, RDS for Microsoft SQL Server, RDS for MySQL et RDS pour PostgreSQL. RDS Proxy permet aux applications de grouper et partager des connexions de base de données pour améliorer la capacité de mise à l’échelle. Pour plus d’informations, consultez [Proxy Amazon RDS ](rds-proxy.md).

## Options d'authentification de base de données
<a name="CHAP_CommonTasks.Connect.DatabaseAuthentication"></a>

Amazon RDS prend en charge les méthodes suivantes pour authentifier les utilisateurs de base de données :
+ **Authentification par mot de passe,** – Votre instance de base de données effectue toute l'administration des comptes d'utilisateurs. Vous créez des utilisateurs et spécifiez des mots de passe avec des instructions SQL. Les instructions SQL que vous pouvez utiliser dépendent de votre moteur de base de données.
+ **Gestion des identités et des accès AWS Authentification de base de données (IAM)** : vous n'avez pas besoin d'utiliser de mot de passe lorsque vous vous connectez à une instance de base de données. En revanche, un jeton d'authentification est nécessaire.
+ **Authentification Kerberos** – Vous utilisez l'authentification externe des utilisateurs de base de données avec Kerberos et Microsoft Active Directory. Kerberos est un protocole d'authentification réseau qui utilise les tickets et la cryptographie de clé symétrique pour vous éviter d'acheminer vos mots de passe via le réseau. Intégré dans Active Directory, Kerberos est conçu pour authentifier les utilisateurs sur les ressources réseau, par exemple les bases de données.

L'authentification de base de données IAM et l'authentification Kerberos sont disponibles uniquement pour des moteurs de base de données et des versions spécifiques.

Pour plus d’informations, consultez [Authentification de base de données avec Amazon RDS ()](database-authentication.md).

## Connexions chiffrées
<a name="CHAP_CommonTasks.Connect.EncryptedConnections"></a>

Vous pouvez utiliser SSL ou TLS à partir de votre application pour chiffrer une connexion à une instance de base de données. Chaque moteur DB possède son propre processus d'implémentation SSL/TLS. Pour plus d’informations, consultez [](UsingWithRDS.SSL.md).

# Utilisation de groupes d’options
<a name="USER_WorkingWithOptionGroups"></a>

Certains moteurs de base de données offrent des fonctions supplémentaires qui facilitent la gestion des données et des bases de données ainsi que la fourniture d’une sécurité supplémentaire pour votre base de données. Amazon RDS utilise des groupes d’options pour activer et configurer ces fonctions. Un *groupe d’options* peut spécifier des fonctions, appelées options, qui sont disponibles pour une instance de base de données Amazon RDS spécifique. Les options peuvent avoir des paramètres spécifiant le mode de fonctionnement de l’option. Lorsque vous associez une instance de base de données a un groupe d’options, les paramètres d’options et les options spécifiés sont activés pour cette instance de base de données. 

 Amazon RDS prend en charge les options pour les moteurs de base de données suivants : 


****  

| Moteur de base de données | Documentation | 
| --- | --- | 
|  `Db2`  |  [Options pour les instances de base de données RDS for Db2](Db2.Options.md)  | 
|  `MariaDB`  |  [Options pour le moteur de base de données MariaDB](Appendix.MariaDB.Options.md)  | 
|  `Microsoft SQL Server`  |  [Options pour le moteur de base de données Microsoft SQL Server](Appendix.SQLServer.Options.md)  | 
|  `MySQL`  |  [Options pour les instances de base de données MySQL](Appendix.MySQL.Options.md)  | 
|  `Oracle`  |  [Ajout d'options aux instances de base de données Oracle](Appendix.Oracle.Options.md)  | 
|  `PostgreSQL`  |  PostgreSQL n’utilise pas d’options et de groupes d’options. PostgreSQL utilise des extensions et des modules pour fournir des fonctionnalités supplémentaires. Pour plus d’informations, consultez [Versions de l'extension PostgreSQL prises en charge](PostgreSQL.Concepts.General.FeatureSupport.Extensions.md).  | 

## Présentation des groupes d’options
<a name="Overview.OptionGroups"></a>

Amazon RDS fournit un groupe d’options vide par défaut pour chaque nouvelle instance DB. Vous ne pouvez ni modifier ni supprimer ce groupe d’options par défaut, mais tout nouveau groupe d’options que vous créez tire ses paramètres du groupe d’options par défaut. Pour appliquer une option à une instance de base de données, vous devez effectuer les opérations suivantes : 

1. Créer un groupe d’options ou copier ou modifier un groupe existant.

1. Ajouter une ou plusieurs options au groupe.

1. Associez le groupe d’options à l’instance de base de données.

   Pour associer un groupe d’options à une instance de base de données, modifiez l’instance de base de données. Pour plus d’informations, consultez [Modification d'une instance de base de données Amazon RDS](Overview.DBInstance.Modifying.md).

Les instances de base de données et les snapshots DB peuvent tous deux être associés à un groupe d’options. Dans certains cas, vous pouvez effectuer une restauration à partir d’un instantané de base de données ou une restauration à un moment dans le temps pour une instance de base de données. Dans ces cas, le groupe d’options associé à l’instantané de base de données ou à l’instance de base de données est associé, par défaut, à l’instance de base de données restaurée. Vous pouvez associer un groupe d’options différent à une instance de base de données restaurée. Toutefois, le nouveau groupe d’options doit contenir toutes les options persistantes ou permanentes qui étaient incluses dans le groupe d’origine. Les options persistantes et permanentes sont décrites ci-dessous.

Les options nécessitent d’avantage de mémoire pour s’exécuter sur une instance de base de données. Ainsi, selon votre utilisation actuelle de l’instance de base de données, il vous faudra peut-être lancer une instance de plus grande taille pour les utiliser. Par exemple, Oracle Enterprise Manager Database Control utilise environ 300 Mo de RAM. Si vous activez cette option pour une petite instance de base de données, vous pouvez rencontrer des problèmes de performances ou de mémoire insuffisante.

### Options persistantes et permanentes
<a name="Overview.OptionGroups.Permanent"></a>

Deux types d’options, persistantes et permanentes, nécessitent une considération spéciale lorsque vous les ajoutez à un groupe d’options. 

Les options persistantes ne peuvent pas être supprimées d’un groupe d’options tant que des instances de base de données sont associées au groupe d’options. L’option TDE pour Microsoft SQL Server TDE (transparent data encryption) est un exemple d’option persistante. Pour qu’une option persistante puisse être supprimée, vous devez dissocier toutes les instances de base de données du groupe d’options. Dans certains cas, vous pouvez effectuer une restauration simple ou une restauration à un moment dans le temps à partir d’un instantané de base de données. Dans ces cas, si le groupe d’options associé à cet instantané de base de données contient une option persistante, vous ne pouvez associer l’instance de base de données restaurée qu’à ce groupe d’options. 

Les options permanentes, telles que l’option TDE pour Oracle Advanced Security TDE, ne peuvent jamais être supprimées d’un groupe d’options. Vous pouvez cependant modifier le groupe d’options d’une instance de base de données qui utilise l’option permanente. Notez cependant que le groupe d’options associé à l’instance de base de données doit inclure la même option permanente. Dans certains cas, vous pouvez effectuer une restauration simple ou une restauration à un moment dans le temps à partir d’un instantané de base de données. Dans ces cas, si le groupe d’options associé à cet instantané de base de données contient une option permanente, vous ne pouvez associer l’instance de base de données restaurée qu’à un groupe d’options avec cette option permanente.

Pour les instances de base de données Oracle, vous pouvez copier les instantanés de bases de données partagés ayant les options `Timezone` ou `OLS` (ou les deux). Pour ce faire, spécifiez un groupe d’options cibles qui inclut ces options lorsque vous copiez l’instantané de bases de données. L’option OLS est permanente et persistante uniquement pour les instances de bases de données Oracle exécutant Oracle version 12.2 ou ultérieure. Pour plus d’informations sur ces options, consultez [Fuseau horaire Oracle](Appendix.Oracle.Options.Timezone.md) et [Oracle Label Security](Oracle.Options.OLS.md).

### Considérations VPC
<a name="Overview.OptionGroups.Platform"></a>

Le groupe d’options associé à l’instance de base de données est lié au VPC de l’instance de base de données. Cela signifie que vous ne pouvez pas utiliser le groupe d’options attribué à une instance de base de données si vous essayez de restaurer l’instance dans un VPC différent. Si vous restaurez une instance de base de données dans un VPC différent, vous pouvez effectuer l’une des opérations suivantes : 
+ Affectez le groupe d’options par défaut à l’instance de base de données.
+ Affectez un groupe d’options qui est lié à ce VPC.
+ Créez un nouveau groupe d’options et affectez-le à l’instance de base de données.

Avec les options permanentes ou persistantes, telles qu’Oracle TDE, vous devez créer un nouveau groupe d’options. Ce groupe d’option doit inclure les options permanentes ou persistantes lorsque vous restaurez une instance de base de données dans un VPC différent.

Les paramètres d’options contrôlent le comportement d’une option. Par exemple, l’option Oracle Advanced Security `NATIVE_NETWORK_ENCRYPTION` a un paramètre que vous pouvez utiliser pour spécifier l’algorithme de chiffrement pour le trafic réseau vers et depuis l’instance de base de données. Certains paramètres d’options sont optimisés pour une utilisation avec Amazon RDS et ne peuvent pas être modifiés.

### Options mutuellement exclusives
<a name="Overview.OptionGroups.Exclusive"></a>

Certaines options sont mutuellement exclusives. Vous pouvez utiliser l’une ou l’autre, mais pas les deux en même temps. Les options suivantes sont mutuellement exclusives : 
+ [Oracle Enterprise Manager Database Express](Appendix.Oracle.Options.OEM_DBControl.md) et [Oracle Management Agent pour Enterprise Manager Cloud Control](Oracle.Options.OEMAgent.md). 
+ [Oracle NNE (Native Network Encryption)](Appendix.Oracle.Options.NetworkEncryption.md) et [Oracle Secure Sockets Layer (SSL)](Appendix.Oracle.Options.SSL.md). 

## Création d’un groupe d’options
<a name="USER_WorkingWithOptionGroups.Create"></a>

Vous pouvez créer un nouveau groupe d’options qui tire ses paramètres du groupe d’options par défaut. Vous ajoutez ensuite une ou plusieurs options au nouveau groupe d’options. Ou si vous avez déjà un groupe d’options existant, vous pouvez également copier ce groupe avec toutes ses options dans un nouveau groupe d’options. Pour plus d’informations, consultez [Copie d’un groupe d’options](#USER_WorkingWithOptionGroups.Copy). 

Une fois que vous avez créé un groupe d’options, il ne contient pas d’options. Pour savoir comment ajouter des options au groupe d’options, consultez la page [Ajout d’une option à un groupe d’options](#USER_WorkingWithOptionGroups.AddOption). Une fois que vous avez ajouté les options que vous voulez, vous pouvez associer une instance de base de données au groupe d’options. De cette façon, les options deviennent disponibles sur l’instance de base de données. Pour plus d’informations sur l’association d’un groupe d’options à une instance de base de données, consultez la documentation pour votre moteur dans [Utilisation de groupes d’options](#USER_WorkingWithOptionGroups). 

### Console
<a name="USER_WorkingWithOptionGroups.Create.Console"></a>

 Une manière de créer un groupe d’options consiste à utiliser la AWS Management Console. 

**Pour créer un nouveau groupe d’options à l’aide de la console**

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 d’options**.

1. Choisissez **Create group**.

1. Dans la fenêtre **Créer un groupe d’options**, procédez comme suit :

   1. Dans la zone **Nom**, saisissez un nom pour le groupe d’options qui soit unique dans votre compte AWS. Le nom ne peut contenir que des lettres, des chiffres et des tirets. 

   1. Pour **Description**, saisissez une brève description du groupe d’options. La description est utilisée à des fins d’affichage. 

   1. Dans la zone **Moteur**, choisissez le moteur de base de données que vous souhaitez. 

   1. Dans la zone **Version majeure du moteur**, choisissez la version majeure du moteur de base de données que vous souhaitez. 

1. Pour continuer, choisissez **Créer**. Pour annuler l’opération à la place, choisissez **Cancel (Annuler)**. 

### AWS CLI
<a name="USER_WorkingWithOptionGroups.Create.CLI"></a>

Pour créer un groupe d’options, utilisez la commande [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/rds/create-option-group.html) de l’`create-option-group` avec les paramètres obligatoires suivants.
+ `--option-group-name`
+ `--engine-name`
+ `--major-engine-version`
+ `--option-group-description`

**Example**  
L’exemple suivant crée un groupe d’options nommé `testoptiongroup` qui est associé au moteur de base de données Oracle Enterprise Edition. La description est entre guillemets.  
Pour Linux, macOS ou Unix :  

```
       
aws rds create-option-group \
    --option-group-name testoptiongroup \
    --engine-name oracle-ee \
    --major-engine-version 19 \
    --option-group-description "Test option group for Oracle Database 19c EE"
```
Pour Windows :  

```
aws rds create-option-group ^
    --option-group-name testoptiongroup ^
    --engine-name oracle-ee ^-
    --major-engine-version 19 ^
    --option-group-description "Test option group for Oracle Database 19c EE"
```

### API RDS
<a name="USER_WorkingWithOptionGroups.Create.API"></a>

Pour créer un groupe d’options, appelez l’opération d’API Amazon RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateOptionGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateOptionGroup.html). Incluez les paramètres suivants :
+ `OptionGroupName`
+ `EngineName`
+ `MajorEngineVersion`
+ `OptionGroupDescription`

## Copie d’un groupe d’options
<a name="USER_WorkingWithOptionGroups.Copy"></a>

Vous pouvez utiliser l’AWS CLI ou l’API Amazon RDS pour copier un groupe d’options. La copie d’un groupe d’options peut s’avérer pratique. Par exemple, lorsque vous avez un groupe d’options existant et que vous souhaitez inclure la plupart de ses valeurs et paramètres personnalisés dans un nouveau groupe d’options. Vous pouvez aussi faire une copie d’un groupe d’options que vous utilisez en production, puis modifier la copie pour tester d’autres paramètres d’options.

**Note**  
Actuellement, vous ne pouvez pas copier un groupe d’options vers une autre région AWS.

### AWS CLI
<a name="USER_WorkingWithOptionGroups.Copy.CLI"></a>

Pour copier un groupe d’options, utilisez la commande [copy-option-group](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-option-group.html) de l’AWS CLI. Inclure les options requises suivantes :
+ `--source-option-group-identifier`
+ `--target-option-group-identifier`
+ `--target-option-group-description`

**Example**  
L’exemple suivant crée un groupe d’options nommé `new-option-group` qui est une copie locale du groupe d’options `my-option-group`.  
Pour Linux, macOS ou Unix :  

```
aws rds copy-option-group \
    --source-option-group-identifier my-option-group \
    --target-option-group-identifier new-option-group \
    --target-option-group-description "My new option group"
```
Pour Windows :  

```
aws rds copy-option-group ^
    --source-option-group-identifier my-option-group ^
    --target-option-group-identifier new-option-group ^
    --target-option-group-description "My new option group"
```

### API RDS
<a name="USER_WorkingWithOptionGroups.Copy.API"></a>

Pour copier un groupe d’options, appelez l’opération d’API Amazon RDS [CopyOptionGroup](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyOptionGroup.html). Incluez les paramètres requis suivants.
+ `SourceOptionGroupIdentifier`
+ `TargetOptionGroupIdentifier`
+ `TargetOptionGroupDescription`

## Ajout d’une option à un groupe d’options
<a name="USER_WorkingWithOptionGroups.AddOption"></a>

Vous pouvez ajouter une option à un groupe d’options existant. Une fois que vous avez ajouté les options que vous voulez, vous pouvez associer une instance de base de données au groupe d’options afin que ces dernières deviennent disponibles sur l’instance de base de données. Pour plus d’informations sur l’association d’un groupe d’options à une instance de base de données, consultez la documentation pour votre moteur de base de données spécifique répertorié à l’adresse [Utilisation de groupes d’options](#USER_WorkingWithOptionGroups). 

Les modifications apportées au groupe d’options doivent être appliquées immédiatement dans deux cas : 
+ Lorsque vous ajoutez une option qui ajoute ou met à jour une valeur de port, telle que l’option `OEM`. 
+ Lorsque vous ajoutez ou supprimez un groupe d’options avec une option qui inclut une valeur de port. 

Dans ces cas, choisissez l’option **Appliquer immédiatement** dans la console. Vous pouvez aussi inclure l’option `--apply-immediately` si vous utilisez l’AWS CLI ou définir le paramètre `ApplyImmediately` sur `true` si vous utilisez l’API Amazon RDS. Les options qui n’incluent pas de valeur de port peuvent être appliquées immédiatement ou pendant la fenêtre de maintenance suivant pour l’instance de base de données. 

**Note**  
Si vous spécifiez un groupe de sécurité comme valeur d’une option dans un groupe d’options, gérez le groupe de sécurité en modifiant le groupe d’options. Vous ne pouvez pas modifier ou supprimer ce groupe de sécurité en modifiant une instance de base de données. En outre, le groupe de sécurité n’apparaît pas dans les détails de l’instance de base de données dans la AWS Management Console ou dans la sortie de la commande de l’AWS CLI `describe-db-instances`.

### Console
<a name="USER_WorkingWithOptionGroups.AddOption.Console"></a>

Vous pouvez utiliser la AWS Management Console pour ajouter une option à un groupe d’options. 

**Pour ajouter une option à un groupe d’options à l’aide de la console**

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 d’options**.

1. Cochez la case pour le groupe d’options que vous souhaitez modifier, puis choisissez **Ajouter une option**.   
![\[Groupe d’options de console\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/optiongroup-addoption1.png)

1. Dans la fenêtre **Ajouter une option**, procédez comme suit : 

   1. Choisissez l’option que vous souhaitez ajouter. Selon l’option que vous sélectionnez, vous devrez peut-être fournir des valeurs supplémentaires. Par exemple, lorsque vous sélectionnez l’option `OEM`, vous devez également saisir une valeur de port et spécifier un groupe de sécurité.

   1. Pour activer l’option sur toutes les instances de base de données associées dès que vous l’ajoutez, pour **Apply Immediately (Appliquer immédiatement)**, choisissez **Oui**. Si vous choisissez **Non** (valeur par défaut), l’option est activée pour chaque instance de base de données associée pendant sa fenêtre de maintenance suivante.  
![\[Groupe d’options de console\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/optiongroup-addoption2.png)

1. Lorsque les paramètres vous conviennent, choisissez **Ajouter une option**.

### AWS CLI
<a name="USER_WorkingWithOptionGroups.AddOptions.CLI"></a>

Pour ajouter une option à un groupe d’options, exécutez la commande [add-option-to-option-group](https://docs.aws.amazon.com/cli/latest/reference/rds/add-option-to-option-group.html) d’AWS CLI avec l’option que vous souhaitez ajouter. Pour activer immédiatement la nouvelle option sur toutes les instances de base de données associées, incluez le paramètre `--apply-immediately`. Par défaut, l’option est activée pour chaque instance de base de données associée pendant sa fenêtre de maintenance suivante. Incluez le paramètre requis suivant :
+ `--option-group-name`

**Example**  
L’exemple suivant ajoute l’option `Timezone`, avec le paramètre `America/Los_Angeles`, à un groupe d’options nommé `testoptiongroup` et l’active immédiatement.  
Pour Linux, macOS ou Unix :  

```
aws rds add-option-to-option-group \
    --option-group-name testoptiongroup \
    --options "OptionName=Timezone,OptionSettings=[{Name=TIME_ZONE,Value=America/Los_Angeles}]" \
    --apply-immediately
```
Pour Windows :  

```
aws rds add-option-to-option-group ^
    --option-group-name testoptiongroup ^
    --options "OptionName=Timezone,OptionSettings=[{Name=TIME_ZONE,Value=America/Los_Angeles}]" ^
    --apply-immediately
```
Le résultat de la commande est similaire à ce qui suit :  

```
...{
       "OptionName": "Timezone",
       "OptionDescription": "Change time zone",
       "Persistent": true,
       "Permanent": false,
       "OptionSettings": [
           {
               "Name": "TIME_ZONE",
               "Value": "America/Los_Angeles",
               "DefaultValue": "UTC",
               "Description": "Specifies the timezone the user wants to change the system time to",
               "ApplyType": "DYNAMIC",
               "DataType": "STRING",
               "AllowedValues": "Africa/Cairo,...",
               "IsModifiable": true,
               "IsCollection": false
           }
       ],
       "DBSecurityGroupMemberships": [],
       "VpcSecurityGroupMemberships": []
   }...
```

**Example**  
L’exemple suivant permet d’ajouter l’option Oracle OEM à un groupe d’options. Il spécifie également un port personnalisé et une paire de groupes de sécurité VPC Amazon EC2 à utiliser pour ce port.  
Pour Linux, macOS ou Unix :  

```
aws rds add-option-to-option-group \
    --option-group-name testoptiongroup \
    --options OptionName=OEM,Port=5500,VpcSecurityGroupMemberships="sg-test1,sg-test2" \
    --apply-immediately
```
Pour Windows :  

```
aws rds add-option-to-option-group ^
    --option-group-name testoptiongroup ^
    --options OptionName=OEM,Port=5500,VpcSecurityGroupMemberships="sg-test1,sg-test2" ^
    --apply-immediately
```
Le résultat de la commande est similaire à ce qui suit :  

```
OPTIONGROUP  False  oracle-ee  19 arn:aws:rds:us-east-1:1234567890:og:testoptiongroup   Test Option Group  testoptiongroup vpc-test 
OPTIONS Oracle 12c EM Express   OEM     False   False   5500
VPCSECURITYGROUPMEMBERSHIPS     active  sg-test1
VPCSECURITYGROUPMEMBERSHIPS     active  sg-test2
```

**Example**  
L’exemple suivant ajoute l’option Oracle `NATIVE_NETWORK_ENCRYPTION` à un groupe d’options et spécifie les paramètres d’options. Si aucun paramètre d’options n’est spécifié, les valeurs par défaut sont utilisées.  
Pour Linux, macOS ou Unix :  

```
aws rds add-option-to-option-group \
    --option-group-name testoptiongroup \
    --options '[{"OptionSettings":[{"Name":"SQLNET.ENCRYPTION_SERVER","Value":"REQUIRED"},{"Name":"SQLNET.ENCRYPTION_TYPES_SERVER","Value":"AES256,AES192,DES"}],"OptionName":"NATIVE_NETWORK_ENCRYPTION"}]' \
    --apply-immediately
```
Pour Windows :  

```
aws rds add-option-to-option-group ^
    --option-group-name testoptiongroup ^
    --options "OptionSettings"=[{"Name"="SQLNET.ENCRYPTION_SERVER","Value"="REQUIRED"},{"Name"="SQLNET.ENCRYPTION_TYPES_SERVER","Value"="AES256\,AES192\,DES"}],"OptionName"="NATIVE_NETWORK_ENCRYPTION" ^
    --apply-immediately
```
Le résultat de la commande est similaire à ce qui suit :  

```
...{
    "OptionName": "NATIVE_NETWORK_ENCRYPTION",
    "OptionDescription": "Native Network Encryption",
    "Persistent": false,
    "Permanent": false,
    "OptionSettings": [
        {
            "Name": "SQLNET.ENCRYPTION_TYPES_SERVER",
             "Value": "AES256,AES192,DES",
            "DefaultValue": "RC4_256,AES256,AES192,3DES168,RC4_128,AES128,3DES112,RC4_56,DES,RC4_40,DES40",
            "Description": "Specifies list of encryption algorithms in order of intended use",
            "ApplyType": "STATIC",
            "DataType": "STRING",
            "AllowedValues": "RC4_256,AES256,AES192,3DES168,RC4_128,AES128,3DES112,RC4_56,DES,RC4_40,DES40",
            "IsModifiable": true,
            "IsCollection": true
        },
        {
            "Name": "SQLNET.ENCRYPTION_SERVER",
            "Value": "REQUIRED",
            "DefaultValue": "REQUESTED",
            "Description": "Specifies the desired encryption behavior",
            "ApplyType": "STATIC",
            "DataType": "STRING",
            "AllowedValues": "ACCEPTED,REJECTED,REQUESTED,REQUIRED",
            "IsModifiable": true,
            "IsCollection": false
        },...
```

### API RDS
<a name="USER_WorkingWithOptionGroups.AddOptions.API"></a>

Pour ajouter une option à un groupe d’options à l’aide de l’API Amazon RDS, appelez l’opération [ModifyOptionGroup](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyOptionGroup.html) avec l’option que vous souhaitez ajouter. Pour activer immédiatement la nouvelle option sur toutes les instances de base de données associées, incluez le paramètre `ApplyImmediately` et affectez-lui la valeur `true`. Par défaut, l’option est activée pour chaque instance de base de données associée pendant sa fenêtre de maintenance suivante. Incluez le paramètre requis suivant :
+ `OptionGroupName`

## Liste des options et des paramètres d’options pour un groupe d’options
<a name="USER_WorkingWithOptionGroups.ListOption"></a>

 Vous pouvez répertorier toutes les options et tous les paramètres d’options pour un groupe d’options. 

### Console
<a name="USER_WorkingWithOptionGroups.ListOption.Console"></a>

Vous pouvez utiliser la AWS Management Console pour répertorier toutes les options et tous les paramètres d’options pour un groupe d’options. 

**Pour répertorier les options et les paramètres d’options pour un groupe d’options**

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 d’options**.

1. Sélectionnez le nom du groupe d’options pour afficher ses informations détaillées. Les options et les paramètres d’options du groupe d’options sont affichés.

### AWS CLI
<a name="USER_WorkingWithOptionGroups.ListOption.CLI"></a>

Pour répertorier les options et les paramètres d’options pour un groupe d’options, utilisez la commande [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-option-groups.html) de l’`describe-option-groups`. Spécifiez le nom du groupe d’options dont vous souhaitez afficher les options et les paramètres. Si vous ne spécifiez pas un nom de groupe d’options, tous les groupes d’options sont décrits. 

**Example**  
L’exemple suivant répertorie les options et les paramètres d’options pour tous les groupes d’options.   

```
aws rds describe-option-groups
```

**Example**  
L’exemple suivant répertorie les options et les paramètres d’options pour un groupe d’options nommé `testoptiongroup`.   

```
aws rds describe-option-groups --option-group-name testoptiongroup
```

### API RDS
<a name="USER_WorkingWithOptionGroups.ListOption.API"></a>

Pour répertorier les options et les paramètres d’options pour un groupe d’options, utilisez l’opération d’API Amazon RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeOptionGroups.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeOptionGroups.html). Spécifiez le nom du groupe d’options dont vous souhaitez afficher les options et les paramètres. Si vous ne spécifiez pas un nom de groupe d’options, tous les groupes d’options sont décrits. 

## Modification d’un paramètre d’option
<a name="USER_WorkingWithOptionGroups.ModifyOption"></a>

Après que vous avez ajouté une option dont les paramètres d’options sont modifiables, vous pouvez modifier les paramètres à tout moment. Si vous modifiez des options ou des paramètres d’options dans un groupe d’options, ces modifications sont appliquées à toutes les instances DB qui sont associées à ce groupe d’options. Pour plus d’informations sur les paramètres disponibles pour les différentes options, consultez la documentation pour votre moteur dans [Utilisation de groupes d’options](#USER_WorkingWithOptionGroups). 

Les modifications apportées au groupe d’options doivent être appliquées immédiatement dans deux cas : 
+ Lorsque vous ajoutez une option qui ajoute ou met à jour une valeur de port, telle que l’option `OEM`. 
+ Lorsque vous ajoutez ou supprimez un groupe d’options avec une option qui inclut une valeur de port. 

Dans ces cas, choisissez l’option **Appliquer immédiatement** dans la console. Vous pouvez aussi inclure l’option `--apply-immediately` si vous utilisez l’AWS CLI ou définir le paramètre `ApplyImmediately` sur `true` si vous utilisez l’API RDS. Les options qui n’incluent pas de valeur de port peuvent être appliquées immédiatement ou pendant la fenêtre de maintenance suivant pour l’instance de base de données. 

**Note**  
Si vous spécifiez un groupe de sécurité comme valeur d’une option dans un groupe d’options, vous gérez le groupe de sécurité en modifiant le groupe d’options. Vous ne pouvez pas modifier ou supprimer ce groupe de sécurité en modifiant une instance de base de données. En outre, le groupe de sécurité n’apparaît pas dans les détails de l’instance de base de données dans la AWS Management Console ou dans la sortie de la commande de l’AWS CLI `describe-db-instances`.

### Console
<a name="USER_WorkingWithOptionGroups.ModifyOption.Console"></a>

Vous pouvez utiliser la AWS Management Console pour modifier un paramètre d’option. 

**Pour modifier un paramètre d’option à l’aide de la console**

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 d’options**. 

1. Sélectionnez le groupe d’options que vous souhaitez modifier, et choisissez **Modify option (Modifier une option)**. 

1. Dans la fenêtre **Modify option (Modifier une option)**, dans la zone **Options installées**, choisissez l’option dont vous souhaitez modifier le paramètre. Apportez les modifications que vous souhaitez.

1. Pour activer l’option dès que vous l’ajoutez, pour **Apply Immediately (Appliquer immédiatement)**, choisissez **Oui**. Si vous choisissez **Non** (valeur par défaut), l’option est activée pour chaque instance de base de données associée pendant sa fenêtre de maintenance suivante. 

1. Lorsque les paramètres vous conviennent, choisissez **Modify Option (Modifier l’option)**.

### AWS CLI
<a name="USER_WorkingWithOptionGroups.ModifyOption.CLI"></a>

Pour modifier un paramètre d’options, utilisez la commande [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/rds/add-option-to-option-group.html) de l’`add-option-to-option-group`. Par défaut, l’option est activée pour chaque instance de base de données associée pendant sa fenêtre de maintenance suivante. Pour appliquer la modification immédiatement à toutes les instances de base de données associées, incluez le paramètre `--apply-immediately`. Pour modifier un paramètre d’option, utilisez l’argument `--settings`.

**Example**  
L’exemple suivant modifie le port que l’Oracle Enterprise Manager Database Control (OEM) utilise dans un groupe d’options nommé `testoptiongroup` et applique immédiatement la modification.   
Pour Linux, macOS ou Unix :  

```
aws rds add-option-to-option-group \
    --option-group-name testoptiongroup \
    --options OptionName=OEM,Port=5432,DBSecurityGroupMemberships=default \
    --apply-immediately
```
Pour Windows :  

```
aws rds add-option-to-option-group ^
    --option-group-name testoptiongroup ^
    --options OptionName=OEM,Port=5432,DBSecurityGroupMemberships=default ^
    --apply-immediately
```
Le résultat de la commande est similaire à ce qui suit :  

```
OPTIONGROUP   False  oracle-ee  19  arn:aws:rds:us-east-1:1234567890:og:testoptiongroup   Test Option Group    testoptiongroup
OPTIONS Oracle 12c EM Express   OEM     False   False   5432
DBSECURITYGROUPMEMBERSHIPS   default  authorized
```

**Example**  
L’exemple suivant modifie l’option Oracle `NATIVE_NETWORK_ENCRYPTION` à un groupe d’options et change les paramètres d’options.   
Pour Linux, macOS ou Unix :  

```
aws rds add-option-to-option-group \
    --option-group-name testoptiongroup \
    --options '[{"OptionSettings":[{"Name":"SQLNET.ENCRYPTION_SERVER","Value":"REQUIRED"},{"Name":"SQLNET.ENCRYPTION_TYPES_SERVER","Value":"AES256,AES192,DES,RC4_256"}],"OptionName":"NATIVE_NETWORK_ENCRYPTION"}]' \
    --apply-immediately
```
Pour Windows :  

```
aws rds add-option-to-option-group ^
    --option-group-name testoptiongroup ^
    --options "OptionSettings"=[{"Name"="SQLNET.ENCRYPTION_SERVER","Value"="REQUIRED"},{"Name"="SQLNET.ENCRYPTION_TYPES_SERVER","Value"="AES256\,AES192\,DES\,RC4_256"}],"OptionName"="NATIVE_NETWORK_ENCRYPTION" ^
    --apply-immediately
```
Le résultat de la commande est similaire à ce qui suit :  

```
OPTIONGROUP   False  oracle-ee  19  arn:aws:rds:us-east-1:1234567890:og:testoptiongroup   Test Option Group    testoptiongroup                
OPTIONS Oracle Advanced Security - Native Network Encryption    NATIVE_NETWORK_ENCRYPTION       False   False
OPTIONSETTINGS  RC4_256,AES256,AES192,3DES168,RC4_128,AES128,3DES112,RC4_56,DES,RC4_40,DES40 STATIC  STRING  
   RC4_256,AES256,AES192,3DES168,RC4_128,AES128,3DES112,RC4_56,DES,RC4_40,DES40    Specifies list of encryption algorithms in order of intended use        
   True     True    SQLNET.ENCRYPTION_TYPES_SERVER  AES256,AES192,DES,RC4_256
OPTIONSETTINGS  ACCEPTED,REJECTED,REQUESTED,REQUIRED    STATIC  STRING  REQUESTED   Specifies the desired encryption behavior  False   True  SQLNET.ENCRYPTION_SERVER    REQUIRED
OPTIONSETTINGS  SHA1,MD5   STATIC  STRING  SHA1,MD5    Specifies list of checksumming algorithms in order of intended use      True    True    SQLNET.CRYPTO_CHECKSUM_TYPES_SERVER  SHA1,MD5
OPTIONSETTINGS  ACCEPTED,REJECTED,REQUESTED,REQUIRED  STATIC  STRING  REQUESTED     Specifies the desired data integrity behavior   False   True    SQLNET.CRYPTO_CHECKSUM_SERVER  REQUESTED
```

### API RDS
<a name="USER_WorkingWithOptionGroups.ModifyOption.API"></a>

Pour modifier un paramètre d’options, utilisez la commande [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyOptionGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyOptionGroup.html) de l’API Amazon RDS. Par défaut, l’option est activée pour chaque instance de base de données associée pendant sa fenêtre de maintenance suivante. Pour appliquer la modification immédiatement à toutes les instances de base de données associées, incluez le paramètre `ApplyImmediately` et affectez-lui la valeur `true`.

## Suppression d’une option d’un groupe d’options
<a name="USER_WorkingWithOptionGroups.RemoveOption"></a>

Certaines options peuvent être supprimées d’un groupe d’options, et certaines ne le peuvent pas. Il n’est pas possible de supprimer une option persistante d’un groupe d’options tant que l’ensemble des instances de base de données associées à ce groupe d’options est dissocié. Une option permanente ne peut jamais être supprimée d’un groupe d’options. Pour plus d’informations sur les options pouvant être supprimées, consultez la documentation pour votre moteur spécifique répertoriée à l’adresse [Utilisation de groupes d’options](#USER_WorkingWithOptionGroups). 

Si vous supprimez tous les éléments d’un groupe d’options, Amazon RDS ne supprime pas ce groupe. Les instances de base de données qui sont associées au groupe d’options vide continuent de l’être. Elles ne comportent simplement plus aucune option active. Pour supprimer toutes les options d’une instance de base de données simultanément, vous pouvez aussi associer l’instance de base de données au groupe d’options par défaut (vide). 

### Console
<a name="USER_WorkingWithOptionGroups.RemoveOption.Console"></a>

Vous pouvez utiliser la AWS Management Console pour supprimer une option d’un groupe d’options. 

**Pour supprimer une option à partir d’un groupe d’options à l’aide de la console**

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 d’options**. 

1. Sélectionnez le groupe d’options que vous souhaitez supprimer, et choisissez **Delete option (Supprimer l’option)**. 

1. Dans la fenêtre **Delete option (Supprimer l’option)**, procédez comme suit : 
   +  Cochez la case correspondant à l’option à supprimer. 
   + Pour que la suppression entre en vigueur dès que vous l’effectuez, pour **Apply immediately (Appliquer immédiatement)**, choisissez **Oui**. Si vous choisissez **Non** (valeur par défaut), l’option est supprimée pour chaque instance de base de données associée pendant sa fenêtre de maintenance suivante.   
![\[Supprimer un groupe d’options\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/optiongroup-removeoption2.png)

1. Lorsque les paramètres vous conviennent, choisissez **Yes, Delete (Oui, supprimer)**. 

### AWS CLI
<a name="USER_WorkingWithOptionGroups.RemoveOption.CLI"></a>

Pour supprimer une option d’un groupe d’options, utilisez la commande [https://docs.aws.amazon.com/cli/latest/reference/rds/remove-option-from-option-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/remove-option-from-option-group.html) de l’AWS CLI. Par défaut, l’option est supprimée de chaque instance de base de données associée pendant sa fenêtre de maintenance suivante. Pour appliquer immédiatement la modification, incluez le paramètre `--apply-immediately`. 

**Example**  
L’exemple suivant supprime l’option Oracle Enterprise Manager Database Control (OEM) d’un groupe d’options nommé `testoptiongroup` et applique immédiatement la modification.   
Pour Linux, macOS ou Unix :  

```
  
aws rds remove-option-from-option-group \
    --option-group-name testoptiongroup \
    --options OEM \
    --apply-immediately
```
Pour Windows :  

```
aws rds remove-option-from-option-group ^
    --option-group-name testoptiongroup ^
    --options OEM ^
    --apply-immediately
```
Le résultat de la commande est similaire à ce qui suit :  

```
OPTIONGROUP    testoptiongroup oracle-ee   19    Test option group
```

### API RDS
<a name="USER_WorkingWithOptionGroups.RemoveOption.API"></a>

Pour supprimer une option d’un groupe d’options, utilisez l’action [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyOptionGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyOptionGroup.html) d’API Amazon RDS. Par défaut, l’option est supprimée de chaque instance de base de données associée pendant sa fenêtre de maintenance suivante. Pour appliquer la modification immédiatement, incluez le paramètre `ApplyImmediately` et affectez-lui la valeur `true`. 

Incluez les paramètres suivants : 
+ `OptionGroupName`
+ `OptionsToRemove.OptionName`

## Suppression d’un groupe d’options
<a name="USER_WorkingWithOptionGroups.Delete"></a>

Vous ne pouvez supprimer un groupe d’options que s’il répond aux critères suivants :
+ Il n’est associé à aucune ressource Amazon RDS. Un groupe d’options peut être associé à une instance de base de données, un instantané de base de données manuel ou un instantané de base de données automatique.
+ Il ne s’agit pas d’un groupe d’options par défaut.

Pour identifier les groupes d’options utilisés par vos instances de base de données et vos instantanés de base de données, vous pouvez utiliser les commandes CLI suivantes :

```
aws rds describe-db-instances \
    --query 'DBInstances[*].[DBInstanceIdentifier,OptionGroupMemberships[].OptionGroupName]'

aws rds describe-db-snapshots | jq -r '.DBSnapshots[] | "\(.DBInstanceIdentifier),\(.OptionGroupName)"' | sort | uniq
```

Si vous tentez de supprimer un groupe d’options associé à une ressource, une erreur similaire à la suivante est renvoyée. 

```
An error occurred (InvalidOptionGroupStateFault) when calling the DeleteOptionGroup operation: The option group 'optionGroupName' cannot be deleted because it is in use.            
```

**Pour rechercher les ressources Amazon RDS associées à un groupe d’options**

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 d’options**. 

1. Sélectionnez le nom du groupe d’options pour afficher ses informations détaillées.

1. Cochez la section **Instances et instantanés associés** pour les ressources Amazon RDS associées.

Si une instance de base de données est associée au groupe d’options, modifiez-la afin qu’elle utilise un autre groupe d’options. Pour plus d’informations, consultez [Modification d'une instance de base de données Amazon RDS](Overview.DBInstance.Modifying.md).

Si un instantané de base de données manuel est associé au groupe d’options, modifiez-le afin qu’il utilise un autre groupe d’options. Vous pouvez le faire à l’aide de la commande AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-snapshot.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-snapshot.html).

**Note**  
Vous ne pouvez pas modifier le groupe d’options d’un instantané de base de données automatique.

### Console
<a name="USER_WorkingWithOptionGroups.Delete.Console"></a>

 Une manière de créer un groupe d’options consiste à utiliser l AWS Management Console. 

**Pour supprimer un groupe d’options à l’aide de la console**

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 d’options**.

1. Choisissez le groupe d’options.

1. Choisissez **Supprimer un groupe**.

1. Dans la page de confirmation, choisissez **Supprimer** pour terminer la suppression du groupe d’options ou **Annuler** pour annuler la suppression.

### AWS CLI
<a name="USER_WorkingWithOptionGroups.Delete.CLI"></a>

Pour supprimer un groupe d’options, utilisez la commande [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/rds/delete-option-group.html) de l’`delete-option-group` avec le paramètre obligatoire suivant.
+ `--option-group-name`

**Example**  
L’exemple suivant supprime un groupe d’options nommé `testoptiongroup`.  
Pour Linux, macOS ou Unix :  

```
       
aws rds delete-option-group \
    --option-group-name testoptiongroup
```
Pour Windows :  

```
aws rds delete-option-group ^
    --option-group-name testoptiongroup
```

### API RDS
<a name="USER_WorkingWithOptionGroups.Delete.API"></a>

Pour supprimer un groupe d’options, appelez l’opération d’API Amazon RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteOptionGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteOptionGroup.html). Incluez le paramètre suivant :
+ `OptionGroupName`

# Groupes de paramètres pour Amazon RDS
<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 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
<a name="parameter-groups-overview"></a>

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
<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 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
<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.
**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
<a name="parameter-groups-overview.maz"></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 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
<a name="parameter-groups-overview.char-sets"></a>

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
<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 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
<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 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
<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 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
<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 RDS
<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 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
<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. 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
<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. 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
<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 RDS
<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/UserGuide/images/param-reboot.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 RDS
<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/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
<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 RDS
<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 RDS
<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 RDS
<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 RDS
<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`

# Utilisation des groupes de paramètres de clusters de bases de données pour les clusters de bases de données Multi-AZ
<a name="USER_WorkingWithDBClusterParamGroups"></a>

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

# Modification des paramètres d'un groupe de paramètres de cluster de base de données
<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’ 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
<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
<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 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
<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
<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": "mydbclusterparametergroup2",
            "DBParameterGroupFamily": "mysql8.0",
            "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
<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": "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
<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
<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`

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

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

*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
<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.  
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
<a name="USER_ParamBooleanExpressions"></a>

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

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

# Création d'un ElastiCache cache Amazon à l'aide des paramètres de l'instance de base de données Amazon RDS du cluster de bases
<a name="creating-elasticache-cluster-with-RDS-settings"></a>

ElastiCache est un service de mise en cache en mémoire entièrement géré qui fournit des latences de lecture et d'écriture de l'ordre de l'ordre de l'ordre de l'ordre de l'ordre de la microseconde pour des cas d'utilisation flexibles en temps réel. ElastiCache peut vous aider à accélérer les performances des applications et des bases de données. Vous pouvez l'utiliser ElastiCache comme magasin de données principal pour les cas d'utilisation qui ne nécessitent pas la durabilité des données, tels que les classements de jeu, le streaming et l'analyse des données. ElastiCache contribue à éliminer la complexité associée au déploiement et à la gestion d'un environnement informatique distribué. Pour plus d'informations, consultez [les sections Cas ElastiCache d'utilisation courants et How ElastiCache Can Help](https://docs.aws.amazon.com/AmazonElastiCache/latest/mem-ug/elasticache-use-cases.html) for Memcached et Cases d'[ ElastiCache utilisation courants et How ElastiCache Can Help](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/elasticache-use-cases.html) for Redis OSS. Vous pouvez utiliser la console Amazon RDS pour créer ElastiCache du cache. 

Vous pouvez utiliser Amazon ElastiCache sous deux formats. Vous pouvez commencer avec un cache sans serveur ou choisir de concevoir votre propre cluster de cache. Si vous choisissez de concevoir votre propre cluster de cache, il ElastiCache fonctionne à la fois avec les moteurs Redis OSS et Memcached. Si vous ne savez pas quel moteur vous souhaitez utiliser, consultez [Comparaison de Memcached et Redis OSS](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/SelectEngine.html). Pour plus d'informations sur Amazon ElastiCache, consultez le [guide de ElastiCache l'utilisateur Amazon](https://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/).

**Topics**
+ [Vue d'ensemble de la création du ElastiCache cache avec les paramètres de l'instance de base de données RDS du cluster de bases](#creating-elasticache-cluster-with-RDS-settings-overview)
+ [Création d'un ElastiCache cache avec les paramètres d'une instance de base de données RDS d'un cluster de base](#creating-elasticache-cluster-with-RDS-settings-new-DB)

## Vue d'ensemble de la création du ElastiCache cache avec les paramètres de l'instance de base de données RDS du cluster de bases
<a name="creating-elasticache-cluster-with-RDS-settings-overview"></a>

Vous pouvez créer un ElastiCache cache à partir d'Amazon RDS en utilisant les mêmes paramètres de configuration qu'une instance de base de données RDS du nouvellement créée ou existante. 

Voici quelques cas d'utilisation pour associer un ElastiCache cache à votre instance de base de données de  de base de données :
+ Vous pouvez réduire les coûts et améliorer vos performances en utilisant ElastiCache RDS plutôt qu'en utilisant RDS uniquement.

  Par exemple, vous pouvez économiser jusqu'à 55 % sur les coûts et obtenir des performances de lecture jusqu'à 80 fois plus rapides en utilisant ElastiCache RDS pour MySQL plutôt que RDS pour MySQL uniquement. 
+ Vous pouvez utiliser le ElastiCache cache comme magasin de données principal pour les applications qui ne nécessitent pas la durabilité des données. Vos applications qui utilisent Redis OSS ou Memcached peuvent l'utiliser pratiquement ElastiCache sans aucune modification.

Lorsque vous créez un ElastiCache cache à partir de RDS, le ElastiCache cache hérite des paramètres suivants de l'instance de base de données RDS associée du  :
+ ElastiCache paramètres de connectivité
+ ElastiCache paramètres de sécurité

Vous pouvez aussi définir les paramètres de configuration du cache en fonction de vos besoins.

### Configuration ElastiCache dans vos applications
<a name="creating-elasticache-cluster-with-RDS-settings-overview-SettingUpELC"></a>

Vos applications doivent être configurées pour utiliser ElastiCache le cache. Vous pouvez également optimiser et améliorer les performances du cache en configurant vos applications pour qu’elles utilisent des stratégies de mise en cache en fonction de vos besoins.
+  Pour accéder à votre ElastiCache cache et commencer, consultez [Getting started with ElastiCache (Redis OSS)](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/GettingStarted.html) et [Getting started with ElastiCache (Memcached](https://docs.aws.amazon.com/AmazonElastiCache/latest/mem-ug/GettingStarted.html)). 
+  Pour plus d’informations sur les stratégies de mise en cache, consultez [Stratégies de mise en cache et bonnes pratiques](https://docs.aws.amazon.com/AmazonElastiCache/latest/mem-ug/BestPractices.html) pour Memcached et [Stratégies de mise en cache et bonnes pratiques](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/BestPractices.html) pour Redis OSS. 
+  Pour plus d'informations sur la haute disponibilité dans les clusters ElastiCache (Redis OSS), voir [Haute disponibilité à l'aide de groupes de réplication](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/BestPractices.html). 
+  Vous pouvez encourir des coûts liés au stockage des sauvegardes, au transfert de données au sein ou entre les régions, ou à l'utilisation de AWS Outposts. Pour plus de détails sur les prix, consultez [ ElastiCache les tarifs Amazon](https://aws.amazon.com/elasticache/pricing/). 

## Création d'un ElastiCache cache avec les paramètres d'une instance de base de données RDS d'un cluster de base
<a name="creating-elasticache-cluster-with-RDS-settings-new-DB"></a>

Vous pouvez créer un ElastiCache cache pour les instances de base de données RDS de vos clusters de base avec des paramètres hérités de l'instance de de base de données. 

**Création d'un ElastiCache cache avec les paramètres d'une instance de de base de données**

1. Pour créer une instance de base de données, suivez les instructions de la section [Création d'une instance de base de données Amazon RDS](USER_CreateDBInstance.md).

1. Après avoir créé une instance de base de données RDS, la console affiche la fenêtre **Modules complémentaires suggérés**. Sélectionnez **Créer un ElastiCache cluster à partir de RDS à l'aide de vos paramètres de base** de données. 

   Pour une base de données existante, sur la page **Bases de données**, sélectionnez l’instance de base de données nécessaire. Dans le menu déroulant **Actions**, choisissez **Create ElastiCache cluster pour créer** un ElastiCache cache dans RDS ayant les mêmes paramètres que votre instance de base de données RDS de existante.

   Dans la **section ElastiCache de configuration**, l'**identifiant de base de données source** indique de quelle instance de de base de données le ElastiCache cache hérite des paramètres.

1. Choisissez si vous voulez créer un cluster Redis OSS ou Memcached. Pour plus d’informations, consultez [Comparaison de Memcached et Redis OSS](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/SelectEngine.html).  
![\[Choisissez le type de cluster et l’option de déploiement.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/EC-RDS-Config.png)

1. Ensuite, choisissez si vous souhaitez créer un **cache sans serveur** ou **concevoir votre propre cache**. Pour plus d’informations, consultez [Choix entre deux options de déploiement](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/WhatIs.deployment.html).

   Si vous choisissez le **cache sans serveur** : 

   1. Dans **Paramètres du cache**, entrez des valeurs pour **Nom** et **Description**. 

   1. Sous **Afficher les paramètres par défaut**, conservez les paramètres par défaut pour établir la connexion entre le cache et l’instance de base de données.

   1. Vous pouvez également modifier les paramètres par défaut en choisissant **Personnaliser les paramètres par défaut**. Sélectionnez les **paramètres de ElastiCache connectivité, les** **paramètres ElastiCache de sécurité** et les **limites d'utilisation maximales**.

1. Si vous choisissez **Créez votre propre cache** : 

   1. Si vous choisissez **Cluster Redis OSS**, indiquez si vous souhaitez conserver le mode cluster **Activé** ou **Désactivé**. Pour plus d’informations, consultez [Réplication : Redis OSS (mode cluster désactivé) vs Redis OSS (mode cluster activé)](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Replication.Redis-RedisCluster.html).

   1. Saisissez des valeurs pour **Nom**, **Description** et **Version du moteur**. 

      Pour **Version du moteur**, la valeur par défaut recommandée est la dernière version du moteur. Vous pouvez également choisir la **version du moteur** qui répond le mieux à vos besoins pour le ElastiCache cache.

   1. Choisissez le type de nœud dans l’option **Type de nœud**. Pour plus d’informations, consultez [Gestion des nœuds](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/CacheNodes.html).

      Si vous choisissez de créer un cluster Redis OSS avec le **mode Cluster** défini sur **Activé**, saisissez le nombre de partitions (partitions/groupes de nœuds) dans l’option **Nombre de partitions**.

      Saisissez le nombre de réplicas de chaque partition dans **Nombre de réplicas**.
**Note**  
Le type de nœud sélectionné, le nombre de partitions et le nombre de réplicas influent tous sur les performances et les coûts de ressources de votre cache. Veillez à ce que ces paramètres correspondent aux besoins de votre base de données. Pour plus d'informations sur les tarifs, consultez [ ElastiCache les tarifs Amazon](https://aws.amazon.com/elasticache/pricing/).

   1. Sélectionnez les **paramètres ElastiCache de connectivité et les** **paramètres ElastiCache de sécurité**. Vous pouvez conserver les paramètres par défaut ou les personnaliser selon vos besoins. 

1. Vérifiez les paramètres par défaut et hérités de votre ElastiCache cache. Certains paramètres ne peuvent pas être modifiés après la création.
**Note**  
RDS peut ajuster la fenêtre de sauvegarde de votre ElastiCache cache pour répondre à la durée minimale requise de 60 minutes. La fenêtre de sauvegarde de votre base de données source reste la même. 

1. Lorsque vous êtes prêt, choisissez **Create ElastiCache cache**.

La console affiche une bannière de confirmation pour la création du ElastiCache cache. Suivez le lien figurant dans la bannière menant à la ElastiCache console pour afficher les détails du cache. La ElastiCache console affiche le ElastiCache cache nouvellement créé. 

# Migration automatique des bases de données EC2 vers Amazon Aurora () à l'aide de AWS Database Migration Service
<a name="USER_DMS_migration"></a>

Vous pouvez utiliser la console RDS pour migrer une base de données EC2 vers RDS. RDS utilise AWS Database Migration Service (AWS DMS) pour migrer votre base de données EC2 source. AWS DMS vous permet de migrer des bases de données relationnelles vers votre AWS Cloud. Pour plus d'informations AWS Database Migration Service, voir [Qu'est-ce que c'est AWS Database Migration Service ?](https://docs.aws.amazon.com/dms/latest/userguide/Welcome.html) dans le *guide de AWS Database Migration Service l'utilisateur*.

Pour commencer la migration, vous devez créer une instance de base de données RDS équivalente dans laquelle migrer les données. Après avoir créé votre base de données cible, vous pouvez y importer votre base de données EC2. Pour les bases de données source inférieures à 1 Tio, cette action de migration réduit le temps et les ressources nécessaires à la migration de vos données dans RDS.

## Présentation de
<a name="USER_DMS_migration-overview"></a>

La console RDS vous permet de migrer des bases de données EC2 vers des bases de données RDS équivalentes. Vous devez créer une base de données RDS pour permettre la migration depuis la console.

Vous pouvez migrer des bases de données EC2 pour les moteurs de base de données suivants :
+ MySQL
+ MariaDB
+ PostgreSQL

Le processus de migration englobe les étapes suivantes :
+ Créez une base de données équivalente dans RDS. Pour que les bases de données soient équivalentes, elles doivent avoir le même moteur de base de données et des versions de moteur compatibles. Elles doivent également se trouver dans le même VPC. Pour obtenir des instructions sur la création de votre base de données, consultez [Création d'une instance de base de données Amazon RDS](USER_CreateDBInstance.md). 
+ Choisissez le type de réplication pour votre base de données :
  + **Migration à charge complète** : RDS copie l’intégralité de la base de données source vers la base de données cible, en créant de nouvelles tables dans la cible si nécessaire.
**Note**  
Cette option entraîne une panne de votre base de données RDS.
  + **Migration à chargement complet et capture des données (CDC)** : similaire à la migration à chargement complet, avec cette option, RDS copie l’intégralité de la base de données source vers la base de données cible. Toutefois, après la migration à chargement complet, RDS applique les modifications capturées dans la source à la base de données cible. La capture des données de modification collecte les journaux de base de données à l’aide de l’API native du moteur de base de données.
**Note**  
Cette option entraîne une panne de votre base de données RDS.
  + **Capture des données de modification (CDC)** : utilisez cette option pour que votre base de données cible reste disponible pendant la migration. RDS migre les modifications en cours dans votre base de données source vers la base de données cible.
+ RDS crée les ressources réseau nécessaires pour faciliter la migration. Une fois qu’RDS a créé les ressources requises, elle vous informe des ressources créées et vous permet de lancer le transfert de données.

  Le temps nécessaire pour effectuer la migration dépend du type de réplication et de la taille de la base de données source.

## Conditions préalables
<a name="USER_DMS_migration-Prerequisites"></a>

### MySQL et MariaDB
<a name="USER_DMS_migration-Prerequisites.MySQL"></a>

Avant de commencer à utiliser une base de données MySQL ou MariaDB comme base de données source, veillez à ce que les conditions préalables suivantes soient remplies. Ces conditions préalables s'appliquent aux sources AWS gérées.

Vous devez disposer d'un compte AWS DMS doté du rôle d'administrateur de réplication. Ce rôle nécessite les privilèges suivants :
+ **REPLICATION CLIENT** : ce privilège est obligatoire pour les tâches de CDC uniquement. En d'autres termes, full-load-only les tâches ne nécessitent pas ce privilège.
+ **REPLICATION SLAVE** : ce privilège est obligatoire pour les tâches de CDC uniquement. En d'autres termes, full-load-only les tâches ne nécessitent pas ce privilège.

L' AWS DMS utilisateur doit également disposer des privilèges SELECT pour les tables sources destinées à la réplication.

Accordez les privilèges suivants si vous utilisez des évaluations de prémigration spécifiques à MySQL.

```
grant select on mysql.user to <dms_user>;
grant select on mysql.db to <dms_user>;
grant select on mysql.tables_priv to <dms_user>;
grant select on mysql.role_edges to <dms_user>  #only for MySQL version 8.0.11 and higher
```

### PostgreSQL
<a name="USER_DMS_migration-Prerequisites.PostgreSQL"></a>

Avant de migrer des données depuis une base de données source AWS PostgreSQL gérée, procédez comme suit :
+ Nous vous recommandons d'utiliser un compte AWS utilisateur avec les autorisations minimales requises pour l'instance de base de données PostgreSQL comme compte utilisateur pour le point de terminaison source PostgreSQL pour. AWS DMS L’utilisation du compte principal n’est pas recommandée. Le compte doit avoir le rôle `rds_superuser` et le rôle `rds_replication`. Le rôle `rds_replication` accorde les autorisations permettant de gérer des emplacements logiques et de diffuser les données à l’aide d’emplacements logiques.

**Note**  
Certaines AWS DMS transactions restent inactives pendant un certain temps avant que le moteur DMS ne les réutilise. En utilisant le paramètre `idle_in_transaction_session_timeout` dans PostgreSQL versions 9.6 et ultérieures, vous pouvez provoquer l’expiration et l’échec des transactions inactives.

## Limitations
<a name="USER_DMS_migration-Limitations"></a>

Les limitations suivantes s’appliquent au processus de migration automatique :
+ Le statut de votre base de données cible doit être **Disponible** pour commencer la migration de la base de données source.
+ Lorsque vous migrez depuis une base de données source MySQL, votre compte RDS doit avoir le rôle d’administrateur de réplication. Vous devez également avoir les privilèges appropriés pour ce rôle.
+ Votre instance EC2 et votre base de données cible doivent être dans le même VPC.
+ Vous ne pouvez pas migrer votre base de données EC2 vers les bases de données cibles suivantes lorsque vous utilisez l’action **Migrer les données de la base de données EC2** :
  + Base de données membre d’un cluster
  + Bases de données Oracle, SQL Server et Db2
  + Bases de données avec MySQL version inférieure à 5.7
  + Bases de données avec PostgreSQL version inférieure à 10.4
  + Bases de données avec MariaDB version inférieure à 10.2

# Création des ressources IAM pour les migrations homogènes
<a name="USER_DMS_migration-IAM"></a>

 RDS les utilise AWS DMS pour migrer vos données. Pour accéder à vos bases de données et migrer les données, AWS DMS créez un environnement sans serveur pour des migrations de données homogènes. Dans cet environnement, AWS DMS nécessite un accès au peering VPC, aux tables de routage, aux groupes de sécurité et à d'autres ressources. AWS AWS DMSStocke également les journaux, les statistiques et la progression de chaque migration de données sur Amazon CloudWatch. Pour créer un projet de migration de données, il AWS DMS faut avoir accès à ces services.

AWS DMSNécessite également l'accès aux secrets qui représentent un ensemble d'informations d'identification utilisateur pour authentifier la connexion à la base de données pour les connexions source et cible.

**Note**  
En utilisant l'action **Migrer les données depuis l' EC2 instance**, vous pouvez utiliser la console RDS pour générer ces ressources IAM. Ignorez cette étape si vous utilisez les ressources IAM générées par la console.

Pour cette procédure, vous avez besoin des ressources IAM suivantes :

**Topics**
+ [Création d’une politique IAM pour les migrations de données homogènes](#USER_DMS_migration-IAM.iam-policy)
+ [Création d’un rôle IAM pour les migrations de données homogènes](#USER_DMS_migration-IAM.iam-role)
+ [Création d’une stratégie d’accès secrète et d’un rôle](USER_DMS_migration-IAM.secret-iam-role-policy.md)
+ [Création d’un rôle IAM pour AWS DMS pour gérer Amazon VPC](USER_DMS_migration-IAM.dms-vpc-role.md)

## Création d’une politique IAM pour les migrations de données homogènes
<a name="USER_DMS_migration-IAM.iam-policy"></a>

Au cours de cette étape, vous créez une politique IAM qui donne accès AWS DMS à Amazon EC2 et à ses CloudWatch ressources. Ensuite, créez un rôle IAM et attachez cette politique.

**Pour créer une politique IAM pour la migration de données**

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

1. Dans le panneau de navigation, choisissez **Politiques**.

1. Choisissez **Create Policy** (Créer une politique).

1. Sur la page **Créer une politique**, choisissez l’onglet **JSON**.

1. Collez le code JSON suivant dans l’éditeur.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "ec2:DescribeRouteTables",
                   "ec2:DescribeSecurityGroups",
                   "ec2:DescribeVpcPeeringConnections",
                   "ec2:DescribeVpcs",
                   "ec2:DescribePrefixLists",
                   "logs:DescribeLogGroups"
               ],
               "Resource": "*"
           },
           {
               "Effect": "Allow",
               "Action": [
                   "servicequotas:GetServiceQuota"
               ],
               "Resource": "arn:aws:servicequotas:*:*:vpc/L-0EA8095F"
           },
           {
               "Effect": "Allow",
               "Action": [
                   "logs:CreateLogGroup",
                   "logs:DescribeLogStreams"
               ],
               "Resource": "arn:aws:logs:*:*:log-group:dms-data-migration-*"
           },
           {
               "Effect": "Allow",
               "Action": [
                   "logs:CreateLogStream",
                   "logs:PutLogEvents"
               ],
               "Resource": "arn:aws:logs:*:*:log-group:dms-data-migration-*:log-stream:dms-data-migration-*"
           },
           {
               "Effect": "Allow",
               "Action": "cloudwatch:PutMetricData",
               "Resource": "*"
           },
           {
               "Effect": "Allow",
               "Action": [
                   "ec2:CreateRoute",
                   "ec2:DeleteRoute"
               ],
               "Resource": "arn:aws:ec2:*:*:route-table/*"
           },
           {
               "Effect": "Allow",
               "Action": [
                   "ec2:CreateTags"
               ],
               "Resource": [
                   "arn:aws:ec2:*:*:security-group/*",
                   "arn:aws:ec2:*:*:security-group-rule/*",
                   "arn:aws:ec2:*:*:route-table/*",
                   "arn:aws:ec2:*:*:vpc-peering-connection/*",
                   "arn:aws:ec2:*:*:vpc/*"
               ]
           },
           {
               "Effect": "Allow",
               "Action": [
                   "ec2:AuthorizeSecurityGroupEgress",
                   "ec2:AuthorizeSecurityGroupIngress"
               ],
               "Resource": "arn:aws:ec2:*:*:security-group-rule/*"
           },
           {
               "Effect": "Allow",
               "Action": [
                   "ec2:AuthorizeSecurityGroupEgress",
                   "ec2:AuthorizeSecurityGroupIngress",
                   "ec2:RevokeSecurityGroupEgress",
                   "ec2:RevokeSecurityGroupIngress"
               ],
               "Resource": "arn:aws:ec2:*:*:security-group/*"
           },
           {
               "Effect": "Allow",
               "Action": [
                   "ec2:AcceptVpcPeeringConnection",
                   "ec2:ModifyVpcPeeringConnectionOptions"
               ],
               "Resource": "arn:aws:ec2:*:*:vpc-peering-connection/*"
           },
           {
               "Effect": "Allow",
               "Action": "ec2:AcceptVpcPeeringConnection",
               "Resource": "arn:aws:ec2:*:*:vpc/*"
           }
       ]
   }
   ```

------

1. Choisissez **Next: Tags** (Suivant : Balises), puis **Next: Review** (Suivant : Vérification).

1. Entrez **HomogeneousDataMigrationsPolicy** pour **Nom\$1**, puis choisissez **Créer une politique**.

## Création d’un rôle IAM pour les migrations de données homogènes
<a name="USER_DMS_migration-IAM.iam-role"></a>

Au cours de cette étape, vous créez un rôle IAM qui donne accès à AWS Secrets Manager Amazon EC2 et CloudWatch.

**Pour créer un rôle IAM pour les migrations de données**

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

1. Dans le panneau de navigation, choisissez **Rôles**.

1. Sélectionnez **Create role** (Créer un rôle).

1. Sur la page **Sélectionner une entité de confiance**, pour **Type d’entité approuvée**, choisissez **Service AWS**. Pour **Cas d’utilisation d’autres services AWS**, choisissez **DMS**.

1. Cochez la case **DMS** et choisissez **Suivant**.

1. Sur la page **Ajouter des autorisations**, choisissez **HomogeneousDataMigrationsPolicy**celle que vous avez créée auparavant. Choisissez **Suivant**.

1. Sur la page **Nommer, vérifier et créer**, entrez **HomogeneousDataMigrationsRole** pour **Nom du rôle** et choisissez **Créer un rôle**.

1. Sur la page **Rôles**, entrez **HomogeneousDataMigrationsRole** pour **Nom du rôle**. Sélectionnez **HomogeneousDataMigrationsRole**.

1. Sur la **HomogeneousDataMigrationsRole**page, choisissez l'onglet **Relations de confiance**. Choisissez **Modifier la politique d’approbation**.

1. Sur la page **Modifier la politique d’approbation**, collez le code JSON suivant dans l’éditeur en remplaçant le texte existant.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Sid": "",
               "Effect": "Allow",
               "Principal": {
                   "Service": [
                       "dms-data-migrations.amazonaws.com",
                       "dms.your_region.amazonaws.com"
                   ]
               },
               "Action": "sts:AssumeRole"
           }
       ]
   }
   ```

------

   Dans l'exemple précédent, remplacez *your\$1region* par le nom de votreRégion AWS.

   La politique basée sur les ressources précédente donne aux responsables de AWS DMS service les autorisations nécessaires pour effectuer des tâches conformément à la politique gérée par le client. **HomogeneousDataMigrationsPolicy**

1. Choisissez **Mettre à jour une politique**.

# Création d’une stratégie d’accès secrète et d’un rôle
<a name="USER_DMS_migration-IAM.secret-iam-role-policy"></a>

Suivez les procédures ci-dessous pour créer votre stratégie d’accès secrète et votre rôle permettant à DMS d’accéder aux informations d’identification utilisateur de vos bases de données source et cible.

**Pour créer la politique et le rôle d'accès secret, qui permettent à Amazon RDS d'accéder AWS Secrets Manager à votre secret approprié**

1. Connectez-vous à la console Gestion des identités et des accès AWS (IAM) AWS Management Console et ouvrez-la à [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)l'adresse.

1. Sélectionnez **Politiques**, puis **Créer une politique**.

1. Choisissez **JSON** et entrez la politique suivante pour permettre d’accéder à votre secret et de le déchiffrer.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": "secretsmanager:GetSecretValue",
               "Resource": "arn:aws:secretsmanager:us-east-1:111122223333:secret:SecretName-ABCDEF"
           },
           {
               "Effect": "Allow",
               "Action": [
                   "kms:Decrypt",
                   "kms:DescribeKey"
               ],
               "Resource": "arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"
           }
       ]
   }
   ```

------

   `secret_arn`Voici l'ARN de votre secret, que vous pouvez obtenir de l'un ou l'autre `SecretsManagerSecretId` selon le cas, et `kms_key_arn` l'ARN de la AWS KMS clé que vous utilisez pour chiffrer votre secret, comme dans l'exemple suivant.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": "secretsmanager:GetSecretValue",
               "Resource": "arn:aws:secretsmanager:us-east-2:123456789012:secret:MySQLTestSecret-qeHamH"
           },
           {
                "Effect": "Allow",
                "Action": [
                           "kms:Decrypt",
                           "kms:DescribeKey"
                         ],
                "Resource": "arn:aws:kms:us-east-2:123456789012:key/761138dc-0542-4e58-947f-4a3a8458d0fd"
           }
        ]
   }
   ```

------
**Note**  
Si vous utilisez la clé de chiffrement par défaut créée par AWS Secrets Manager, il n'est pas nécessaire de spécifier les AWS KMS autorisations pour`kms_key_arn`.  
Si vous souhaitez que votre politique donne accès aux deux secrets, il vous suffit de spécifier un objet de ressource JSON supplémentaire pour l'autre*secret\$1arn*.

1. Vérifiez et créez la politique avec un nom convivial et une description facultative.

1. Choisissez **Rôles**, puis **Créer un rôle**.

1. Choisissez **Service AWS ** comme type d’entité de confiance.

1. Choisissez **DMS** dans la liste des services comme service de confiance, puis choisissez **Suivant : Autorisations**.

1. Recherchez et attachez la politique que vous avez créée à l’étape 4, puis ajoutez des balises et passez en revue votre rôle. À ce stade, modifiez les relations d’approbation du rôle afin d’utiliser votre principal de service régional Amazon RDS comme entité de confiance. Ce principal a le format suivant.

   ```
   dms.region-name.amazonaws.com
   ```

   Ici, *`region-name`* est le nom de votre région, par exemple `us-east-1`. Il est suivi par un principal de service régional Amazon RDS pour cette région.

   ```
   dms.us-east-1.amazonaws.com
   dms-data-migrations.amazonaws.com
   ```

# Création d’un rôle IAM pour AWS DMS pour gérer Amazon VPC
<a name="USER_DMS_migration-IAM.dms-vpc-role"></a>

Vous devez créer un rôle IAM pour AWS DMS pour gérer les paramètres VPC de vos ressources. Ce rôle doit être disponible pour que la migration soit réussie.

**Création du `dms-vpc-role` pour la migration de base de données**

1. Connectez-vous à la AWS Management Console, puis ouvrez la console IAM à l’adresse [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. Dans le panneau de navigation de la console, choisissez **Rôles**, puis **Créer un rôle**.

1. Choisissez l’option **Service AWS** pour l’option **Sélectionner une entité de confiance**.

   Pour **Cas d’utilisation**, sélectionnez **DMS.**

1. Pour l’étape **Ajouter des autorisations**, sélectionnez `AmazonDMSVPCManagementRole` et choisissez **Suivant**.

1. Sur la page **Nommer, vérifier et créer**, définissez le **Nom du rôle** sur `dms-vpc-role` et choisissez **Créer un rôle**.

Cela crée le rôle permettant au DMS de gérer les paramètres VPC pour la migration.

# Configuration de la migration des données pour la base de données EC2
<a name="USER_DMS_migration-SetUp"></a>

Pour commencer à migrer des données depuis votre base de données source EC2, vous devez créer une base de données RDS équivalente. Pour obtenir des instructions sur la création de votre base de données, consultez [Création d'une instance de base de données Amazon RDS](USER_CreateDBInstance.md).

Après avoir créé votre base de données cibles, procédez comme suit pour configurer la migration des données :

**Configuration d’un projet de migration des données**

1. Sélectionnez la base de données cible sur la page **Bases de données** de la console RDS.

1. Choisissez le menu déroulant **Actions** et sélectionnez l’option **Migrer les données depuis la base de données EC2**. Pour obtenir la liste des bases de données cibles prises en charge, consultez [Limitations](USER_DMS_migration.md#USER_DMS_migration-Limitations).

1. Dans la section **Sélectionner la base de données EC2 source** :

   1. Vérifiez le **type de moteur** et assurez-vous qu’il est identique à celui de votre base de données source.

      Vérifiez également si les versions du moteur sont compatibles.

   1. Pour **Instance EC2**, choisissez l’instance EC2 où réside votre base de données source.

   1. Pour **Port**, entrez le port sur lequel votre base de données source autorise le trafic.

   1. Pour **Secret**, choisissez **Créer et utiliser un nouveau secret** si vous n’en avez pas déjà un. Ajoutez le **Nom d’utilisateur** et le **Mot de passe** de votre base de données source. Choisissez également la clé KMS avec laquelle chiffrer votre secret.

      Si vous utilisez un secret existant, sélectionnez **Utiliser un secret existant** puis choisissez un secret dans la liste déroulante.

   1. Pour **rôle IAM pour le secret**, si vous avez un rôle IAM existant, sélectionnez **Utiliser un rôle IAM existant** et choisissez un rôle AM dans la liste déroulante qui peut accéder à l’ID secret de l’étape précédente.

      Si vous ne disposez pas de rôle IAM, choisissez **Créer et utiliser un nouveau rôle IAM**. Pour **Nom du rôle IAM, entrez un nouveau nom pour votre rôle. Vous pouvez consulter les autorisations associées à ce rôle dans le lien ci-dessous.**

1. Dans la section **Afficher la base de données RDS cible** :

   1. Confirmez les paramètres de votre base de données cible en haut de la section.

   1. Pour **Secret**, choisissez **Créer et utiliser un nouveau secret** si vous n’en avez pas déjà un qui comporte les informations d’identification de votre base de données cible.

      Si vous utilisez un secret existant, sélectionnez-le dans la liste déroulante.

   1. Pour **Rôle IAM pour le secret**, sélectionnez un rôle IAM qui peut accéder au secret depuis l’étape précédente. Vous pouvez également créer un nouveau rôle IAM si vous n’avez pas de rôle IAM existant.

      Si la liste déroulante ne contient pas les rôles IAM, spécifiez l’**ARN du rôle IAM** au format `arn:aws:iam:account_id:role/roleName`.

1. Dans la section **Configurer la migration des données** :

   1. Sélectionnez le type de migration des données en choisissant entre **Chargement complet**, **Capture des données de chargement complet et de modification (CDC)** ou **Capture de données modifiées (CDC)**. Pour plus d’informations sur ces options, consultez [Présentation de](USER_DMS_migration.md#USER_DMS_migration-overview).

      Vous ne pouvez pas modifier le type de migration une fois celle-ci lancée. 

   1. Pour **Rôle IAM pour la migration des données**, si vous avez un rôle IAM existant, sélectionnez **Utiliser un rôle IAM existant** et choisissez un rôle IAM dans la liste déroulante qui accorde à DMS les autorisations nécessaires pour créer les ressources nécessaires à la migration. Si vous ne disposez pas de rôle IAM, choisissez **Créer et utiliser un nouveau rôle IAM**.

1. Vérifiez que l’onglet **Afficher les paramètres de migration** affiche les paramètres requis pour que votre migration de données soit correctement configurée.

1. Sélectionnez **Migrer** pour terminer la configuration de la migration.

Une fois ces étapes terminées, vous pouvez voir les ressources en cours de configuration pour la migration des données en choisissant **Afficher les détails** dans la bannière de progression de la console. Une fois les ressources requises configurées, la migration démarre automatiquement. Si vous créez 

Pour migrer plusieurs bases de données vers la base de données cible, recommencez ce processus avec des informations sur la nouvelle base de données EC2.

# Gestion des migrations de données
<a name="USER_DMS_migration.Managing"></a>

Après avoir utilisé l’action **Migrer les données depuis la base de données EC2** depuis la console RDS, RDS démarre automatiquement la migration.

Si vous avez utilisé la console AWS DMS pour créer les ressources de migration, vous pouvez démarrer le processus de migration.

## Démarrage de la migration des données
<a name="USER_DMS_migration.Managing.Start"></a>

Pour démarrer la migration des données, procédez comme suit :

**Démarrage d’une migration des données**

1. Choisissez la base de données cible sur la page **Bases de données** de la console RDS.

1. Sur la page de détails de la base de données, sélectionnez l’onglet **Migrations de données**.

1. Sous l’onglet **Migrations de données**, **Migrations de données associées** répertorie les migrations de données disponibles.

   Les migrations configurées à l’aide de la console RDS démarrent automatiquement une fois que les ressources requises sont configurées.

   Les migrations configurées à l’aide de la console DMS sont définies sur **Prêt**.

   Pour commencer ces migrations, sélectionnez le menu déroulant **Actions**, puis sélectionnez **Démarrer**.

1. Cela commence la migration des données pour votre base de données EC2.

## Arrêt de la migration des données
<a name="USER_DMS_migration.Managing.Stop"></a>

Pour les migrations de données dont le type de réplication est à pleine charge, l’arrêt de la migration entraîne l’arrêt du processus et ne peut pas être repris. Une fois la migration arrêtée, vous devez redémarrer la migration.

Pour les migrations dont le type de réplication est défini pour modifier la capture des données (CDC) ou pour le chargement complet et le CDC, vous pouvez arrêter le processus de réplication continue et le reprendre ultérieurement.

**Arrêt d’une migration des données**

1. Choisissez la base de données cible sur la page **Bases de données** de la console RDS.

1. Sur la page de détails de la base de données, sélectionnez l’onglet **Migrations de données**.

1. Sous l’onglet **Migrations de données**, **Migrations de données associées** répertorie les migrations de données en cours.

   Pour arrêter une migration, sélectionnez une migration de données, puis sélectionnez **Arrêter** dans le menu déroulant **Actions**.

1. Cela arrête la migration des données pour votre base de données EC2.

## Reprise de la migration des données
<a name="USER_DMS_migration.Managing.Resuming"></a>

Pour les migrations de données dont le type de réplication est Capture des données de chargement complet et de modification (CDC) ou Capture de données modifiées (CDC), vous pouvez reprendre le processus CDC depuis le dernier arrêt.

**Reprise d’une migration des données**

1. Choisissez la base de données cible sur la page **Bases de données** de la console RDS.

1. Sur la page de détails de la base de données, sélectionnez l’onglet **Migrations de données**.

1. Sous l’onglet **Migrations de données**, **Migrations de données associées** répertorie les migrations de données arrêtées.

   Pour reprendre une migration, sélectionnez une migration de données, puis sélectionnez **Reprendre le traitement** dans le menu déroulant **Actions**.

1. Cela reprend la migration des données pour votre base de données EC2.

## Suppression de la migration des données
<a name="USER_DMS_migration.Managing.Deleting"></a>

Pour supprimer une migration de données associée, suivez les instructions suivantes

**Suppression d’une migration des données**

1. Choisissez la base de données cible sur la page **Bases de données** de la console RDS.

1. Sur la page de détails de la base de données, sélectionnez l’onglet **Migrations de données**.

1. Pour supprimer une migration, sélectionnez une migration de données, puis sélectionnez **Supprimer** dans le menu déroulant **Actions**.

1. Cela supprime la migration des données.

La suppression d’une migration de données en cours n’a aucune incidence sur les données déjà chargées dans la base de données cible.

## Redémarrage de la migration des données
<a name="USER_DMS_migration.Managing.Restarting"></a>

Pour redémarrer une migration de données associée depuis un point de départ CDC, suivez les instructions suivantes

**Redémarrage d’une migration des données**

1. Choisissez la base de données cible sur la page **Bases de données** de la console RDS.

1. Sur la page de détails de la base de données, sélectionnez l’onglet **Migrations de données**.

1. Pour redémarrer une migration, sélectionnez une migration de données, puis sélectionnez **Redémarrer** dans le menu déroulant **Actions**.

1. Cela redémarre la migration des données à partir d’un point de départ du CDC.

Le redémarrage d’une migration de données en cours n’a aucune incidence sur les données déjà chargées dans la base de données cible.

# Surveillance des migrations de données
<a name="USER_DMS_migration.Monitoring"></a>

Une fois les migrations de données démarrées, vous pouvez surveiller leur statut et leur progression. Les migrations de jeux de données de grande taille prennent des heures. Pour gérer la fiabilité, la disponibilité et les performances de votre migration de données, surveillez régulièrement sa progression.

**Pour vérifier le statut et la progression de votre migration de données**

1. Choisissez la base de données cible sur la page **Bases de données** de la console RDS.

1. Sur la page de détails de la base de données, sélectionnez l’onglet **Migrations de données**.

1. La section **Migrations de données associées** répertorie vos migrations de données. Vérifiez la colonne **Statut**.

1. Pour les migrations de données en cours, la colonne **Processus de migration** affiche le pourcentage de données migrées.

1. Pour surveiller le processus dans CloudWatch, utilisez le lien figurant dans la colonne **CloudWatch**.

## Statuts de migration
<a name="USER_DMS_migration.Monitoring.status"></a>

Pour chaque migration de données que vous exécutez, la console RDS affiche le **Statut**. La liste suivante inclut les statuts :
+ `Ready` : la migration de données est prête à démarrer.
+ `Starting` : RDS crée l’environnement sans serveur pour votre migration de données.
+ `Load running` : RDS effectue la migration de chargement complet.
+ `Load complete, replication ongoing` : RDS a terminé le chargement complet et réplique désormais les modifications en cours. Ce statut s’applique uniquement aux migrations à chargement complet et aux migrations de type CDC.
+ `Replication ongoing` : RDS réplique les modifications en cours. Ce statut s’applique uniquement aux migrations de type CDC.
+ `Stopping` : RDS arrête les migrations de données. Ce statut s’applique lorsque vous choisissez d’arrêter la migration des données à partir du menu **Actions**.
+ `Stopped` : RDS a arrêté les migrations de données.
+ `Failed` : la migration de données a échoué. Pour plus d’informations, consultez les fichiers journaux.
+ `Restarting` : la migration des données a relancé une réplication de données en cours depuis un point de départ CDC.

# Tutoriel : Création d'un de base de données MySQL avec un paramètre personnalisé et un nouveau groupe d'options
<a name="tutorial-creating-custom-OPG"></a>

Dans ce didacticiel, vous créez une instance de base de données MySQL à l’aide d’un groupe de paramètres personnalisé et d’un nouveau groupe d’options. Pour plus d’informations sur les groupes de paramètres personnalisés et les groupes d’options, consultez [Groupes de paramètres pour Amazon RDS](USER_WorkingWithParamGroups.md) et [Utilisation de groupes d’options](USER_WorkingWithOptionGroups.md). 

**Important**  
La création d'un AWS compte est gratuite. Cependant, en suivant ce didacticiel, les AWS ressources que vous utilisez peuvent vous coûter cher. Vous pouvez supprimer ces ressources après avoir terminé le didacticiel si elles ne sont plus nécessaires.

Pour créer une instance de bases de données avec des configurations et des paramètres personnalisés, vous pouvez utiliser un groupe de paramètres personnalisé et de nouveaux groupes d’options. Les groupes de paramètres personnalisés et les nouveaux groupes d’options sont particulièrement utiles si vous travaillez avec plusieurs bases de données et souhaitez configurer leurs paramètres de manière uniforme.

En suivant ces étapes, vous apprendrez à :
+ Comment utiliser Amazon RDS pour créer une instance de base de données à l’aide d’un groupe de paramètres personnalisé et d’un nouveau groupe d’options.
+ Comment utiliser des paramètres et des options spécifiques pour des instances de base de données MySQL. 

Pour suivre ce didacticiel, effectuez les tâches suivantes :

1. Créez un groupe de paramètres personnalisé à l’aide des paramètres MySQL `default_password_lifetime` et `disconnect_on_expired_password`. 

1. Créez un nouveau groupe d’options avec la fonctionnalité d’options `MariaDB Audit Plugin` MySQL. Pour savoir comment créer un groupe d’options, consultez [Utilisation de groupes d’options](USER_WorkingWithOptionGroups.md). 

1. Créez une instance de base de données MySQL à l’aide d’un groupe de paramètres personnaliséet du nouveau groupe d’options que vous avez créés.

**Topics**
+ [Conditions préalables](#tutorial-creating-custom-OPG.Prerequisites)
+ [Création d'un groupe de paramètres de](#tutorial-creating-custom-OPG.create-parameter-group)
+ [Modification des valeurs de paramètre dans votre groupe de paramètres personnalisé](#tutorial-creating-custom-OPG.add-parameters)
+ [Création d’un nouveau groupe d’options Amazon RDS](#tutorial-creating-custom-OPG.create-option-group)
+ [Ajout d’une option à votre nouveau groupe d’options](#tutorial-creating-custom-OPG.add-options)
+ [Création d’une instance de base de données MySQL à l’aide d’un groupe de paramètres custom et d’un nouveau groupe d’options](#tutorial-creating-custom-OPG.create-OPG)

## Conditions préalables
<a name="tutorial-creating-custom-OPG.Prerequisites"></a>

Ce didacticiel nécessite que vous disposiez d'un Compte AWS et d'un utilisateur disposant d'un accès administratif. Si vous ne l’avez pas encore fait, suivez les étapes indiquées dans les sections ci-dessous pour vous préparer :
+ [Inscrivez-vous pour un Compte AWS](CHAP_SettingUp.md#sign-up-for-aws)
+ [Création d’un utilisateur doté d’un accès administratif](CHAP_SettingUp.md#create-an-admin)

## Création d'un groupe de paramètres de
<a name="tutorial-creating-custom-OPG.create-parameter-group"></a>

Dans ce didacticiel, vous apprendrez à créer un groupe de paramètres personnalisé avec [ default\$1password\$1lifetime](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html#sysvar_default_password_lifetime) et [ disconnect\$1on\$1expired\$1password](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html#sysvar_disconnect_on_expired_password) pour une instance de base de données MySQL dans la console. Le paramètre `default_password_lifetime` contrôle le nombre de jours avant l’expiration automatique du mot de passe du client. Le paramètre `disconnect_on_expired_password` contrôle si l’instance de base de données MySQL déconnecte le client lorsque le mot de passe expire. Pour plus d’informations sur les autres paramètres disponibles pour les instances de bases de données MySQL, consultez [Paramètres pour MySQL](Appendix.MySQL.Parameters.md) . 

**Pour créer un groupe de paramètres**

1. Ouvrez la console Amazon RDS et choisissez **Groupes de paramètres**. 

1. Sur la page **Groupes de paramètres personnalisés**, choisissez **Créer un groupe de paramètres**. 

1. Définissez les détails du groupe de paramètres.

   1. Entrez un nom pour le groupe de paramètres.

   1. Entrez une description du groupe de paramètres.

   1. Pour **Type de moteur**, choisissez **Communauté MySQL.** 

   1. Pour **Famille de groupes de paramètres**, choisissez **MySQL 8.0.** 

1. Choisissez **Créer**. 

Le nouveau groupe de paramètres apparaît sur la page **Groupes de paramètres** de la console Amazon RDS. Les étapes suivantes montrent comment modifier les valeurs des paramètres pour personnaliser votre groupe de paramètres. 

## Modification des valeurs de paramètre dans votre groupe de paramètres personnalisé
<a name="tutorial-creating-custom-OPG.add-parameters"></a>

Procédez comme suit pour modifier les valeurs de paramètre dans le groupe de paramètres que vous avez créé dans [Création d'un groupe de paramètres de ](#tutorial-creating-custom-OPG.create-parameter-group). 

**Pour modifier les valeurs de paramètre dans votre groupe de paramètres**

1. Ouvrez la console Amazon RDS et choisissez **Groupes de paramètres**. 

1. Pour **Groupes de paramètres personnalisés**, choisissez le nom du groupe de paramètres que vous avez créé.

1. Choisissez **Modifier**. 

1. Dans la zone de recherche **Paramètres de filtre**, recherchez le paramètre personnalisé `default_password_lifetime`. 

1. Cochez la case à côté du paramètre et entrez une valeur correspondant au nombre de jours à définir pour ce paramètre de durée de vie du mot de passe. 

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

1. Répétez les mêmes étapes pour le paramètre ` disconnect_on_expired_password`. Lorsque vous choisissez ce paramètre, vous êtes invité à sélectionner la valeur 0 ou 1 dans le menu déroulant. Sélectionnez 1 pour vous déconnecter en cas de mot de passe expiré. 

Le groupe de paramètres personnalisé peut désormais être associé à Amazon RDS pour l’instance de base de données MySQL 8.0. Créez ensuite un nouveau groupe d’options pour votre instance de base de données.

## Création d’un nouveau groupe d’options Amazon RDS
<a name="tutorial-creating-custom-OPG.create-option-group"></a>

Créez un nouveau groupe d’options avec l’option [Plugin d’audit MariaDB](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.MySQL.Options.AuditPlugin.html). Ce plugin enregistre l’activité du serveur à des fins de sécurité et de conformité. Pour plus d’informations sur les autres options disponibles pour les instances de bases de données MySQL, consultez [Options pour les instances de base de données MySQL](Appendix.MySQL.Options.md). 

**Pour créer un groupe d’options**

1. Ouvrez la console Amazon RDS et choisissez **Groupes d’options**. 

1. Pour **Groupes d’options**, choisissez **Créer un groupe**. 

1. Définissez les détails du groupe d’options.
   + Saisissez un nom pour le groupe d’options.
   + Entrez une description du groupe d’options.
   + Pour **Moteur**, sélectionnez **mysql**. 
   + Pour **Version majeure du moteur**, choisissez **8.0**. 

1. Choisissez **Créer**. 

Le nouveau groupe d’options apparaît sur la page **Groupes d’options** de la console Amazon RDS. Les étapes suivantes montrent comment ajouter des options au groupe d’options. 

## Ajout d’une option à votre nouveau groupe d’options
<a name="tutorial-creating-custom-OPG.add-options"></a>

Procédez comme suit pour ajouter une option au nouveau groupe d’options que vous avez créé dans [Création d’un nouveau groupe d’options Amazon RDS](#tutorial-creating-custom-OPG.create-option-group). 

**Pour ajouter une option à votre groupe d’options**

1. Ouvrez la console Amazon RDS et choisissez **Groupes d’options**. 

1. Pour **Groupes d’options**, choisissez le nom du groupe d’options que vous avez créé.

1. Sous **Options**, choisissez **Ajouter une option**. 

1. Définissez les détails du groupe d’options.
   + Pour **Nom de l’option**, choisissez l’option Plugin d’audit MariaDB, **MARIADB\$1AUDIT\$1PLUGIN**. 
   + Pour **Paramètres d’options**, ne désélectionnez pas les options par défaut.
   + Pour **Appliquer immédiatement**, choisissez **Oui**. 

1. Choisissez l’**option Créer**. 

Le nouveau groupe d’options devrait désormais être disponible pour toutes les instances de base de données associées. Ensuite, créez une instance de base de données MySQL à l’aide du groupe de paramètres personnalisé et d’un nouveau groupe d’options.

## Création d’une instance de base de données MySQL à l’aide d’un groupe de paramètres custom et d’un nouveau groupe d’options
<a name="tutorial-creating-custom-OPG.create-OPG"></a>

Enfin, créez une instance de base de données MySQL avec le groupe de paramètres personnalisé que vous avez crééet un nouveau groupe d’options que vous avez créés lors des étapes précédentes. Les étapes suivantes montrent comment créer l’instance de base de données MySQL avec votre groupe de paramètres personnalisé et un nouveau groupe d’options.

**Pour créer une instance de base de données à l’aide d’un groupe de paramètres personnalisé et d’un nouveau groupe d’options**

1. Ouvrez la console Amazon RDS et choisissez **Bases de données**. 

1. Choisissez **Créer une base de données**.

1. Pour **Choisir une méthode de création de base de données**, choisissez **Création standard**.

1. Pour **Options de moteur**, choisissez **MySQL** .

1. Pour **Disponibilité et durabilité**, choisissez **Instance de base de données unique.** Cette étape est nécessaire pour prendre en charge un groupe de paramètres personnalisé ou un nouveau groupe d’options.

1. Choisissez **Configuration supplémentaire**.
   + Pour **Nom de la base de données initiale**, choisissez un nom pour votre Instance de base de données.
   + Dans le menu déroulant du groupe de paramètres , choisissez le nom du groupe de paramètres personnalisé que vous avez créé auparavant.
   + Dans la liste déroulante **Groupe d’options**, sélectionnez le nom du nouveau groupe d’options précédemment créé. 

1. Pour ce didacticiel, vous pouvez conserver les paramètres par défaut pour tous les autres paramètres de base de données ou les modifier selon vos besoins. 

1. Choisissez **Créer une base de données**.

RDS crée une nouvelle instance de base de données MySQL à l’aide d’un groupe de paramètres personnaliséet d’un nouveau groupe d’options. Pour plus d’informations sur cette base de données, consultez la page **Bases de données** de la console Amazon RDS.

Dans ce didacticiel, vous créez MySQL une instance de base de données MySQL à l’aide d’un groupe de paramètres personnalisé et d’un nouveau groupe d’options. L’instance de base de données MySQL tout juste créée gère la durée de vie du mot de passe utilisateur à l’aide du paramètre `default_password_lifetime`. Cette instance de base de données déconnecte également les utilisateurs qui se connectent avec un mot de passe expiré, à l’aide du paramètre `disconnect_on_expired_password`. Vous pouvez également utiliser l’option `MariaDB Audit Plugin` pour suivre l’activité du serveur. Pour optimiser votre base de données, vous pouvez appliquer des paramètres supplémentaires à votre groupe de paramètres personnalisé et ajouter des options. 

 Une fois que vous avez terminé de créer votre instance de base de données personnalisée, vous devez supprimer vos ressources pour éviter d’encourir des coûts indésirables. Pour supprimer une instance de base de données, suivez les instructions de  [Suppression d'une instance DB](USER_DeleteInstance.md).  