

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.

# DBeaver À utiliser pour accéder à Aurora DSQL
<a name="accessing-dbeaver"></a>

DBeaver est un client SQL universel qui peut être utilisé pour gérer n'importe quelle base de données dotée d'un pilote JDBC. Il est largement utilisé par les développeurs et les administrateurs de bases de données en raison de ses fonctionnalités robustes de visualisation, d'édition et de gestion des données. Grâce DBeaver aux options de connectivité au cloud, vous pouvez vous connecter DBeaver nativement à Aurora DSQL.

## DBeaver Pro
<a name="dbeaver-pro"></a>

DBeaver Les produits PRO offrent une intégration native avec Aurora DSQL à partir de la version 25.3. Suivez les instructions de la [DBeaver documentation](https://dbeaver.com/docs/dbeaver/Database-driver-Aurora-DSQL/) pour vous connecter à votre cluster Aurora DSQL.

## DBeaver Édition communautaire
<a name="dbeaver-community"></a>

DBeaver Community Edition est la version gratuite et open source. Consultez la [page de téléchargement](https://dbeaver.io/download/) pour obtenir les instructions d'installation. Pour vous connecter à DSQL depuis DBeaver Community Edition, vous devez installer le [plug-in Aurora DSQL pour](https://github.com/awslabs/aurora-dsql-dbeaver-plugin). DBeaver

Le [plug-in Aurora DSQL pour DBeaver](https://github.com/awslabs/aurora-dsql-dbeaver-plugin) est basé sur le [connecteur Aurora DSQL pour JDBC](https://github.com/awslabs/aurora-dsql-jdbc-connector) et permet l'authentification IAM sur les clusters Aurora DSQL. Il est facilement installé via l' DBeaver interface utilisateur et élimine le besoin d'écrire le code de génération du jeton ou de fournir manuellement un jeton IAM valide, simplifiant ainsi l'authentification tout en éliminant les risques de sécurité associés aux mots de passe traditionnels générés par les utilisateurs.

### Caractéristiques
<a name="features"></a>
+  Support de l'authentification IAM : connectez-vous aux clusters SQL Aurora à l'aide des informations d'identification AWS IAM pour une authentification sécurisée et sans mot de passe 
+  Gestion automatique des pilotes : installe et configure en toute simplicité le connecteur Aurora DSQL pour JDBC 
+  Options de connexion flexibles : choisissez entre une configuration de connexion basée sur l'hôte ou basée sur une URL JDBC 

### Plug-in SQL Aurora pour l'installation DBeaver
<a name="installation"></a>

1.  Une DBeaver fois ouvert, allez dans le menu déroulant **Aide** → **Installer un nouveau logiciel** 

1.  Cliquez sur **Ajouter** pour ajouter un nouveau référentiel 

1.  Entrez : 
   +  **Nom**: `Aurora DSQL Plugin` 
   +  **Lieu** : `https://awslabs.github.io/aurora-dsql-dbeaver-plugin/update-site/` 

1.  Vérifiez le **connecteur SQL Aurora pour JDBC** 

1.  Cliquez sur **Suivant**, acceptez la licence et terminez l'installation 

1.  Redémarrer DBeaver lorsque vous y êtes invité 

### Création d'une connexion SQL Aurora
<a name="create-connection"></a>

1.  Cliquez sur le bouton **Nouvelle connexion à la base de données** 

1.  Sélectionnez **Aurora DSQL** 

1.  Sous **Serveur**, sélectionnez l'une des options suivantes pour le paramètre **Connect by** 
   + **Host** 
     +  pour activer la saisie de texte dans l'interface utilisateur pour les champs suivants : 
       +  Point de **terminaison : point** de terminaison du cluster SQL 
       +  **Nom d'utilisateur : nom** d'utilisateur DSQL (par exemple admin) 
       +  **Profil AWS :** par exemple, par défaut : profil standard utilisé lorsqu'aucun profil spécifique n'est spécifié 
       +  **Région AWS (facultatif) :** doit correspondre à la région dans laquelle se trouve votre cluster SQL, sinon l'authentification échouera 
   +  **URL** 
     + URL JDBC au format suivant : 

       ```
       jdbc:aws-dsql:postgresql://{cluster_endpoint}/{database}?user=admin&profile=default&region=us-east-1
       ```
     +  Remarque : Dans ce mode, seule la saisie d'URL est activée. Pour ajouter des paramètres à la chaîne de connexion JDBC, utilisez le format des paramètres de requête URL commençant par ? comme premier paramètre et ajoutez un & pour les paramètres suivants. 

1.  Cliquez sur **Tester la connexion** pour vérifier que la connexion Aurora DSQL fonctionne. 

1.  Cliquez sur **Terminer** 

## Résolution des problèmes
<a name="troubleshooting"></a>

### Problème avec le Windows Trust Store
<a name="windows-trust-store"></a>

Les utilisateurs de Windows peuvent rencontrer des problèmes lors du téléchargement du pilote Aurora DSQL Connector pour JDBC depuis Maven Central.

**Cause :** Windows Trust Store peut ne pas inclure les certificats requis pour accéder au référentiel Maven Central.

**Solution :**

1. Exécuter DBeaver en tant qu' « administrateur »

1. Décochez ce paramètre : Windows > Préférences > Connexions > « Utiliser Windows Trust Store »

### Erreur de pilote manquant
<a name="missing-driver"></a>

Si une icône de pilote est manquante ou si des erreurs de connexion s'affichent, il est possible que le plug-in communautaire Aurora DSQL ne soit pas installé dans votre DBeaver version actuelle. Voici quelques exemples d'erreurs et comment les corriger :
+ Création d'une nouvelle connexion avec le pilote manquant :  
![Icône de pilote manquante dans DBeaver](http://docs.aws.amazon.com/fr_fr/aurora-dsql/latest/userguide/images/dbeaver-missing-driver-icon.png)
+ Tentative de connexion sans le pilote :  
![Boîte de dialogue d'erreur lorsque le pilote est manquant](http://docs.aws.amazon.com/fr_fr/aurora-dsql/latest/userguide/images/dbeaver-version-error-dialog.png)

**Cause :** Lorsque plusieurs DBeaver versions sont installées, les paramètres de connexion sont partagés mais les pilotes sont installés par application.

**Solution :** Réinstallez Aurora DSQL (plug-in communautaire) en suivant les étapes d'installation ci-dessus.



**Important**  
Les fonctionnalités administratives fournies par DBeaver les bases de données PostgreSQL (**telles que Session** Manager **et Lock** Manager) ne s'appliquent pas aux bases de données Aurora DSQL en raison de leur architecture unique. Bien qu'accessibles, ces écrans ne fournissent pas d'informations fiables sur l'état ou l'état de la base de données.