

# Accès à Amazon RDS en utilisant AWS Toolkit for JetBrains
<a name="accessing-rds"></a>

Grâce à Amazon Relational Database Service (Amazon RDS), vous pouvez provisionner et gérer des systèmes de bases de données relationnelles SQL dans le cloud. En utilisant AWS Toolkit for JetBrains, vous pouvez vous connecter et interagir avec les moteurs de base de données Amazon RDS suivants :
+ Aurora : une base de données relationnelle compatible avec MySQL et PostgreSQL conçue pour le cloud. Pour plus d'informations, consultez le [https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html).
+ MySQL : Amazon RDS for MySQL prend en charge plusieurs versions majeures de la base de données relationnelle open source. Pour plus d'informations, consultez [MySQL sur Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html) dans le *Guide de l'utilisateur Amazon RDS*.
+ PostgreSQL : Amazon RDS prend en charge plusieurs versions majeures de la base de données relationnelle objet open source. Pour plus d'informations, consultez [PostgreSQL pour Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html) dans le *Guide de l'utilisateur Amazon RDS*.

Les rubriques suivantes décrivent les conditions préalables pour accéder aux bases de données RDS et comment utiliser AWS Toolkit for JetBrains pour se connecter à une instance de base de données.

**Topics**
+ [Conditions préalables à l'accès aux bases de données Amazon RDS](rds-access-prerequisities.md)
+ [Connexion à une base de données Amazon RDS](rds-connection.md)

# Conditions préalables à l'accès aux bases de données Amazon RDS
<a name="rds-access-prerequisities"></a>

Avant de pouvoir vous connecter à une base de données Amazon RDS à l'aide d'AWS Toolkit for JetBrains, vous devez effectuer les tâches suivantes : 
+ [Créer une instance de base de données et configurer sa méthode d'authentification](#db-authentication)
+ [Télécharger et installer DataGrip](#datagrip-info)

## Création d'une instance de base de données Amazon RDS et configuration d'une méthode d'authentification
<a name="db-authentication"></a>

 AWS Toolkit for JetBrains vous permet de vous connecter à une instance de base de données Amazon RDS qui a déjà été créée et configurée dans AWS. Une instance de base de données est un environnement de base de données isolé fonctionnant dans le cloud et pouvant contenir plusieurs bases de données créées par l'utilisateur. Pour plus d'informations sur la création d'instances de base de données pour les moteurs de base de données pris en charge, reportez-vous à la section [Démarrer avec les ressources Amazon RDS](Amazon RDS User GuideCHAP_GettingStarted.html) du *Guide de l'utilisateur Amazon RDS*. 

Lorsqu'ils se connectent à une base de données à l'aide d'AWS Toolkit for JetBrains, les utilisateurs peuvent choisir de s'authentifier à l'aide d'informations d'identification IAM ou de Secrets Manager. Le tableau suivant décrit les principales fonctionnalités et les ressources d'information pour les deux options : 


****  

| Méthodes d'authentification | Comment ça marche | En savoir plus | 
| --- | --- | --- | 
|  Se connecter avec les informations d'identification IAM  |  Avec l'authentification IAM de base de données, vous n'avez pas besoin de stocker les informations d'identification des utilisateurs dans la base de données, car l'authentification est gérée en externe à l'aide des informations d'identification Gestion des identités et des accès AWS (IAM).Par défaut, l'authentification de base de données IAM est désactivée sur les instances de bases de données. Vous pouvez activer l'authentification de base de données IAM (ou la désactiver à nouveau) à l'aide de AWS Management Console, de l'AWS CLI ou de l'API.   |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/toolkit-for-jetbrains/latest/userguide/rds-access-prerequisities.html)  | 
|  Se connecter avec AWS Secrets Manager  |  Un administrateur de base de données peut stocker des informations d'identification pour une base de données en tant que secret dans Secrets Manager. Secrets Manager chiffre et stocke les informations d'identification dans le secret en tant que *texte secret protégé*. Lorsqu'une application disposant d'autorisations accède à la base de données, Secrets Manager déchiffre le texte secret protégé et le renvoie sur un canal sécurisé. Le client analyse les informations d'identification renvoyées, la chaîne de connexion et toute autre information requise, puis utilise ces informations pour accéder à la base de données.  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/toolkit-for-jetbrains/latest/userguide/rds-access-prerequisities.html)  | 

## Travailler avec les bases de données Amazon RDS en utilisant DataGrip
<a name="datagrip-info"></a>

Après vous être connecté à une source de données Amazon RDS, vous pouvez commencer à interagir avec elle. En utilisant DataGrip de JetBrains, vous pouvez effectuer des tâches de base de données telles que l'écriture de SQL, l'exécution de requêtes et l'importation/exportation de données. Les fonctionnalités fournies par DataGrip sont également disponibles dans le plugin de base de données pour une gamme d'IDE JetBrains. Pour plus d'informations sur DataGrip, consultez le site [https://www.jetbrains.com/datagrip/](https://www.jetbrains.com/datagrip/).

# Connexion à une base de données Amazon RDS
<a name="rds-connection"></a>

Avec **AWS Explorer**, vous pouvez sélectionner une base de données Amazon RDS, choisir une méthode d'authentification, puis configurer les paramètres de connexion. Après avoir testé avec succès la connexion, vous pouvez commencer à interagir avec la source de données en utilisant JetBrains DataGrip. 

**Important**  
Assurez-vous que vous avez rempli les [conditions préalables](rds-access-prerequisities.md) pour permettre aux utilisateurs d'accéder et d'interagir avec les bases de données Amazon RDS.

Sélectionnez un onglet pour obtenir des instructions sur la connexion à une instance de base de données en utilisant votre méthode d'authentification préférée.

------
#### [ Connect with IAM credentials ]

1. Ouvrez AWS Explorer, s'il n'est pas déjà ouvert.

1. Cliquez sur le nœud **Amazon RDS** pour développer la liste des moteurs de base de données pris en charge.

1. Cliquez sur un nœud de moteur de base de données pris en charge (Aurora, MySQL ou PostgreSQL) pour développer la liste des instances de base de données disponibles.
**Note**  
Si vous sélectionnez Aurora, vous pouvez choisir entre le développement d'un cluster MySQL et d'un cluster PostgreSQL. 

1. Cliquez avec le bouton droit de la souris sur une base de données et choisissez **Connecter avec les informations d'identification IAM**.
**Note**  
Vous pouvez également choisir **Copier l'ARN** pour ajouter l'Amazon Resource Name (ARN) de la base de données à votre presse-papier.

1. Dans la boîte de dialogue **Sources de données et pilotes**, procédez comme suit pour vous assurer qu'une connexion à la base de données peut être ouverte :
   + Dans le panneau **Sources de données importées**, confirmez que la source de données correcte est sélectionnée.
   + Si un message indique que vous devez **télécharger les fichiers de pilote manquants**, choisissez **Aller au pilote** (l'icône de la clé à molette) pour télécharger les fichiers requis.

1. Dans l'onglet **Général** du panneau **Paramètres**, confirmez que les champs suivants affichent les valeurs correctes : 
   + **Hôte/Port** : le point de terminaison et le port utilisés pour les connexions à la base de données. Pour les bases de données Amazon RDS hébergées dans le cloud AWS, les points de terminaison se terminent toujours par `rds.amazon.com`. Si vous vous connectez à une instance de base de données via un proxy, utilisez ces champs pour spécifier les détails de connexion du proxy.
   + **Authentification** : **AWS IAM** (authentification à l'aide des informations d'identification IAM).
   + **Utilisateur** : le nom du compte utilisateur de votre base de données.
   + **Informations d'identification** : les informations d'identification utilisées pour accéder à votre compte AWS. 
   + **Région** : la région AWS dans laquelle la base de données est hébergée. 
   + **Hôte/Port RDS** : le point de terminaison et le port de la base de données tels qu'ils sont répertoriés dans AWS Management Console. Si vous utilisez un point de terminaison différent pour vous connecter à une instance de base de données, indiquez les détails de connexion du proxy dans les champs **Hôte/Port** (décrits précédemment).
   + **Base de données** : le nom de la base de données. 
   + **URL** : l'URL que l'IDE JetBrains utilisera pour se connecter à la base de données.  
![\[Paramètres de connexion pour une base de données Amazon RDS avec des informations d'identification IAM utilisées pour l'authentification.\]](http://docs.aws.amazon.com/fr_fr/toolkit-for-jetbrains/latest/userguide/images/rds-auth-iam.png)
**Note**  
Pour une description complète des paramètres de connexion que vous pouvez configurer en utilisant la boîte de dialogue **Sources de données et pilotes**, consultez la [documentation de l'EDI JetBrains](https://www.jetbrains.com/help/) que vous utilisez. 

1. Pour vérifier que les paramètres de connexion sont corrects, sélectionnez **Tester la connexion**.

   Une coche verte indique que le test a réussi.

1. Choisissez **Appliquer** pour appliquer vos paramètres, puis **OK** pour commencer à travailler avec la source de données.

   La fenêtre de l'outil **Base de données** s'ouvre. Elle affiche les sources de données disponibles sous la forme d'une arborescence dont les nœuds représentent les éléments de la base de données tels que les schémas, les tables et les clés. 
**Important**  
Pour utiliser la fenêtre de l'outil **Base de données**, vous devez d'abord télécharger et installer DataGrip de JetBrains. Pour plus d'informations, consultez le site [https://www.jetbrains.com/datagrip/](https://www.jetbrains.com/datagrip/). 

------
#### [ Connect with Secrets Manager ]

1. Ouvrez AWS Explorer, s'il n'est pas déjà ouvert.

1. Cliquez sur le nœud **Amazon RDS** pour développer la liste des moteurs de base de données pris en charge.

1. Cliquez sur un nœud de moteur de base de données pris en charge (Aurora, MySQL ou PostgreSQL) pour développer la liste des instances de base de données disponibles.
**Note**  
Si vous sélectionnez Aurora, vous pouvez choisir entre le développement d'un cluster MySQL et d'un cluster PostgreSQL. 

1. Cliquez avec le bouton droit de la souris sur une base de données et choisissez **Connecter avec Secrets Manager**.
**Note**  
Vous pouvez également choisir **Copier l'ARN** pour ajouter l'Amazon Resource Name (ARN) de la base de données à votre presse-papier.

1. Dans la boîte de dialogue **Sélectionner un secret de base de données**, utilisez le champ déroulant pour choisir les informations d'identification de la base de données, puis choisissez **Créer**.

1. Dans la boîte de dialogue **Sources de données et pilotes**, procédez comme suit pour vous assurer qu'une connexion à la base de données peut être ouverte :
   + Dans le panneau **Sources de données importées**, confirmez que la source de données correcte est sélectionnée.
   + Si un message indique que vous devez **télécharger les fichiers de pilote manquants**, choisissez **Aller au pilote** (l'icône de la clé à molette) pour télécharger les fichiers requis.

1. Dans l'onglet **Général** du panneau **Paramètres**, confirmez que les champs suivants affichent les valeurs correctes : 
   + **Hôte/Port** : le point de terminaison et le port utilisés pour les connexions à la base de données. Pour les bases de données Amazon RDS hébergées dans le cloud AWS, les points de terminaison se terminent toujours par `rds.amazon.com`. Si vous vous connectez à une base de données par l'intermédiaire d'une base de données proxy, utilisez ces champs pour spécifier les détails de connexion du proxy.
   + **Authentification** : **SecretsManager Auth** (authentification à l'aide d'AWS Secrets Manager).
   + **Informations d'identification** : les informations d'identification utilisées pour accéder à votre compte AWS.
   + **Région** : la région AWS dans laquelle la base de données est hébergée. 
   + **Nom/ARN du secret** : le nom et l'ARN du secret contenant les informations d'identification. Pour remplacer les paramètres de connexion dans les champs **Hôte/Port**, cochez la case **Utiliser l'URL et le port du secret**. 
   + **Base de données** : le nom de l'instance de la base de données que vous avez sélectionnée dans **AWS Explorer**. 
   + **URL** : l'URL que l'IDE JetBrains utilisera pour se connecter à la base de données.
**Note**  
Si vous utilisez Secrets Manager pour l'authentification, il n'y a pas de champs pour un nom d'utilisateur et un mot de passe pour la base de données. Ces informations sont contenues dans la partie des données secrètes chiffrées d'un secret.  
![\[Paramètres de connexion avec des informations d'identification IAM utilisées pour l'authentification.\]](http://docs.aws.amazon.com/fr_fr/toolkit-for-jetbrains/latest/userguide/images/rds-auth-asm.png)
**Note**  
Pour une description complète des paramètres de connexion que vous pouvez configurer en utilisant la boîte de dialogue **Sources de données et pilotes**, consultez la [documentation de l'EDI JetBrains](https://www.jetbrains.com/help/) que vous utilisez. 

1. Pour vérifier que les paramètres de connexion sont corrects, sélectionnez **Tester la connexion**.

   Une coche verte indique que le test a réussi.

1. Choisissez **Appliquer** pour appliquer vos paramètres, puis **OK** pour commencer à travailler avec la source de données.

   La fenêtre de l'outil **Base de données** s'ouvre. Elle affiche les sources de données disponibles sous la forme d'une arborescence dont les nœuds représentent les éléments de la base de données tels que les schémas, les tables et les clés. 
**Important**  
Pour utiliser la fenêtre de l'outil **Base de données**, vous devez d'abord télécharger et installer DataGrip de JetBrains. Pour plus d'informations, consultez le site [https://www.jetbrains.com/datagrip/](https://www.jetbrains.com/datagrip/). 

------