Connectez-vous avec DBeaver

DBeaver est un outil polyvalent de gestion de base de données universelle qui prend en charge un large éventail de bases de données, y compris PostgreSQL. Il fournit un riche ensemble de fonctionnalités pour l'administration de bases de données, le développement de requêtes et la visualisation de données.

Prérequis

• DBeaver Communauté ou Enterprise edition installée sur votre système
• Un projet Lakebase avec un rôle Postgres configuré

remarque

Nous recommandons d'utiliser l' authentification par mot de passe Postgres natif lors de la connexion avec DBeaver. Les mots de passe Postgres natifs n'expirent pas toutes les heures comme les jetons OAuth, ce qui les rend mieux adaptés aux applications qui ne peuvent pas refresh fréquemment les informations d'identification. Consultez l'aperçu de l'authentification pour plus de détails sur les méthodes d'authentification.

Installer DBeaver

Si vous n'avez pas installé DBeaver, download et installez-le à partir du site web de DBeaver.

Comprendre la chaîne de connexion

Lakebase fournit une chaîne de connexion qui contient toutes les informations nécessaires pour se connecter. Voici comment l'analyser :

postgresql://role_name:password@ep-abc-123.databricks.com/databricks_postgres?sslmode=require
             ^         ^        ^                         ^
       user -|         |        |- hostname               |- database
                       |
                       |- password

remarque

DBeaver et d'autres outils basés sur Java fonctionnent mieux lorsque vous fournissez les détails de connexion dans des champs séparés plutôt que sous forme de chaîne de connexion.

Pour plus de détails sur les chaînes de connexion, consultez Chaînes de connexion.

Se connecter à votre base de données

1. Obtenez les détails de connexion de Lakebase :

   • Accédez à l'application Lakebase et sélectionnez votre projet.
   • Cliquez sur Connecter pour ouvrir la fenêtre modale de connexion à la base de données
   • Sélectionnez la Branch, le compute et la base de données auxquels vous souhaitez vous connecter.
   • Sélectionnez un rôle Postgres dans le menu déroulant (nous vous recommandons d'utiliser un rôle Postgres natif avec authentification par mot de passe).
   • Notez les détails de la connexion

2. Créez une nouvelle connexion à la base de données dans DBeaver :

   • Ouvrez DBeaver.
   • Cliquez sur le bouton Nouvelle connexion à la base de données (icône de prise) ou sélectionnez Base de données > Nouvelle connexion à la base de données dans le menu
   • Dans l'assistant Connexion à la base de données , sélectionnez PostgreSQL dans la liste des types de base de données.
   • Cliquez sur Suivant

3. Saisissez les détails de connexion :

   • Hôte : Saisissez le hostname de votre Endpoint de compute (par exemple, ep-abc-123.databricks.com)
   • Port : 5432
   • **Base de données** : Saisissez le nom de votre base de données (pardatabricks_postgres exemple,)
   • Nom d'utilisateur : saisissez le nom de votre rôle Postgres (par exemple : role_name)
   • Mot de passe : Saisissez le mot de passe de votre rôle Postgres.
   • **Afficher toutes les bases de données** : activez cette option pour voir toutes les bases de données de votre projet.

4. Configurer SSL :

   • Cliquez sur Modifier les paramètres du Driver
   • Sous l'onglet Propriétés du Driver , recherchez sslmode et définissez-le sur require
   • Cliquez sur OK pour revenir à la boîte de dialogue de connexion.

5. Tester et enregistrer la connexion :

   • Cliquez sur Test de connexion pour vérifier les détails de la connexion.
   • En cas de succès, cliquez sur Terminer pour enregistrer la connexion.

Votre connexion à la base de données Lakebase apparaîtra désormais dans la barre latérale gauche, sous Database Navigator.

Utilisation de DBeaver

Une fois connecté, vous pouvez :

Exécuter des requêtes SQL

• Cliquez avec le bouton droit sur votre connexion de base de données dans la barre latérale gauche.
• Sélectionnez **Éditeur SQL** > **Nouveau script SQL**
• Saisissez vos query SQL dans l'éditeur.
• Cliquez sur le bouton Exécuter (icône de lecture) pour les exécuter
• Affichez les résultats dans le volet des résultats en dessous de l'éditeur.

Gérer les tables

• Développez votre connexion de base de données dans la barre latérale gauche
• Accédez à **Bases de données** > **[votre base de données]** > **Schémas** > **public** > **Tables**
• Cliquez avec le bouton droit sur Tables pour créer une nouvelle table.
• Cliquez avec le bouton droit sur une table existante pour la visualiser, la modifier ou la gérer.

Importer et exporter des données

Pour importer des données :

• Faites un clic droit sur un tableau et sélectionnez Importer des données
• Choisissez le format de fichier source (par ex. : CSV, JSON)
• Suivez les invites pour mapper les colonnes et importer

Pour exporter des données :

• Cliquez avec le bouton droit sur une table et sélectionnez Exporter les données
• Choisissez le format d'exportation (par exemple, CSV, JSON)
• Suivez les invites pour enregistrer le fichier.

Générateur de query visuel

DBeaver inclut un constructeur de query visuel qui vous permet de construire des queries graphiquement en sélectionnant des tables, des colonnes et des conditions.

Dépannage

Chaîne de connexion non acceptée

DBeaver et d'autres outils basés sur Java qui utilisent le driver pgJDBC pourraient ne pas prendre en charge l'inclusion du nom de rôle et du mot de passe dans une chaîne de connexion de base de données. Si vous rencontrez des problèmes avec les chaînes de connexion, utilisez plutôt les champs de détails de connexion séparés comme décrit dans ce guide.

Sécurité de la connexion

Lakebase exige que toutes les connexions utilisent le chiffrement SSL/TLS. Assurez-vous que sslmode est défini sur require dans les propriétés du Driver.

Pour plus d'informations sur les chaînes de connexion et les options d'authentification, consultez Se connecter à votre projet.