Serveur d'impression

Pilotes de base de données – Dbeaver – Serveur d’impression

Le 25 avril 2020 - 10 minutes de lecture

Vous pouvez utiliser un pilote de base de données préconfiguré ou créer un nouveau pilote.

DBeaver possède de nombreux pilotes préconfigurés, notamment SQL, NoSQL, des bases de données de valeurs-clés, des bases de données graphiques, des moteurs de recherche, etc.
Mais parfois, vous devez vous connecter à une base de données qui n'a pas encore été configurée dans DBeaver.

Tout ce dont vous avez besoin est un pilote JDBC de votre base de données. Le reste est facile.

Obtention du pilote JDBC

Le pilote JDBC est un programme (en Java) qui peut se connecter et fonctionner avec un serveur de base de données local ou distant. Il fournit généralement toutes les fonctionnalités nécessaires pour couvrir 100% des fonctionnalités de la base de données. Habituellement, les pilotes JDBC sont fournis par les fournisseurs de bases de données pour permettre aux clients de travailler avec leurs bases de données.

Le pilote JDBC se compose d'un ou de plusieurs pot des dossiers. Le fichier Jar est une bibliothèque qui contient du code de programme et d'autres fichiers.
Vous devez télécharger les fichiers jar du pilote avant de les ajouter dans DBeaver. Parfois, les fichiers jar sont inclus dans la distribution du serveur de base de données – dans ce cas, vous devez consulter la documentation de votre base de données ou demander à votre administrateur de base de données.

Ajout de la configuration du pilote dans DBeaver

Ouvrir la boîte de dialogue du gestionnaire de pilotes

Vous pouvez ouvrir le gestionnaire de pilotes à partir du menu principal:

ou à partir du menu déroulant du Navigateur de base de données.

Ajouter un nouveau pilote

Cliquez simplement sur le bouton Nouveau et créez un nouveau pilote.
Dans la boîte de dialogue d'édition du pilote, vous devez saisir toutes les informations requises:

Paramètres principaux

Paramètre La description
Nom du conducteur Nom de votre chauffeur. Cela peut être n'importe quel nom que vous aimez
Type de pilote Fournisseur de pilotes. Dans 99% des cas, vous aurez besoin d'un pilote générique (fournisseur JDBC)
Nom du cours Nom de classe de pilote JDBC. Vous pouvez l'obtenir à partir de la documentation ou le trouver dans des fichiers jar (voir la description du bouton "Rechercher une classe")
Modèle d'URL Modèle d'URL du pilote. Vous pouvez le laisser vide. Mais dans ce cas, vous serez prêt à définir l'URL JDBC pour chaque connexion. Il est préférable de définir un modèle valide, cela simplifiera considérablement la création de connexions. Voir "Modèles d'URL" pour la description détaillée
Port par défaut Port de base de données par défaut. Vous pouvez l'obtenir à partir de la documentation ou le laisser vide
Intégré Activez-le pour les bases de données sans serveur. Cet indicateur affecte quelques options de configuration liées à la gestion du réseau / des connexions
Pas d'authentification Cela signifie que le pilote ne nécessite pas d'authentification (aucun champ utilisateur / mot de passe ne sera affiché)
Catégorie Catégorie de pilote, obsolète
Identifiant ID unique du pilote, ignorez-le
La description Description du pilote, il est affiché dans certaines boîtes de dialogue / assistants comme un indice
Bibliothèques

Il s'agit de la liste des fichiers jar, des bibliothèques binaires (dll environ) et de tout autre fichier requis par le pilote. Dans la plupart des cas, vous n'avez besoin que de fichiers jar.
Cliquez sur "Ajouter un fichier" pour ajouter un fichier jar unique, "Ajouter un dossier" pour ajouter un dossier avec les classes / ressources Java et "Ajouter un artefact" pour ajouter un artefact Maven (voir ci-dessous).

Après avoir ajouté des fichiers jar, vous pourrez trouver toutes les classes de pilotes JDBC présentes dans ces jars. Cliquez simplement sur le bouton "Rechercher une classe" et DBeaver les affichera tous. Dans la plupart des cas, il n'y a qu'une seule classe de pilote dans le pilote. S'il y en a beaucoup, vous devez vous référer à la documentation du pilote.

Artefacts Maven

DBeaver peut télécharger des fichiers pilotes directement depuis le référentiel Maven (il s'agit d'un référentiel public mondial de bibliothèques Java, généralement open-source). Si votre pilote de base de données est publié sur un référentiel public, vous pouvez utiliser cette fonctionnalité. Les artefacts Maven sont meilleurs que les fichiers jar ordinaires car vous pouvez voir toutes les versions de pilote existantes et pouvez changer la version du pilote lors de l'exécution sans aucune reconfiguration des propriétés du pilote.

Enregistrement du pilote, ajout d'une connexion

Une fois la configuration de votre pilote terminée, appuyez simplement sur le bouton OK.
Maintenant vous pouvez [[create connection]].

Si vous devez modifier certaines propriétés de pilote ultérieurement, vous pouvez y accéder directement à partir de la boîte de dialogue des propriétés de connexion:

Modèles d'URL

Les pilotes JDBC utilisent des URL pour identifier les serveurs distants – des chaînes similaires aux URL Web classiques.
Habituellement, l'URL a la forme jdbc: fournisseur: hôte: port / base de données, par exemple `jdbc: postgresql: localhost: 5432 / postgres '.
Il n'est pas très pratique d'éditer une chaîne aussi longue et non évidente.
DBeaver peut construire cette URL à partir des paramètres de connexion (comme l'hôte, le port, etc.).

Par exemple, au-dessus du modèle d'URL: jdbc: postgresql: // host: port / base de données
L'hôte, le port et la base de données sont des paramètres que vous devrez saisir sur la page de configuration de la connexion.

Variables d'URL prises en charge:

Paramètre La description
hôte Nom d'hôte du serveur de base de données
Port Numéro de port du serveur de base de données
base de données Nom de la base de données cible
serveur Nom du serveur cible (rarement utilisé)
dossier Chemin du dossier (sur le système de fichiers local). Utilisé pour les pilotes intégrés
fichier Chemin d'accès au fichier (sur le système de fichiers local). Utilisé pour les pilotes intégrés

Réglages avancés

Pour la plupart des pilotes, vous n'avez pas besoin de modifier les propriétés avancées.
Mais dans certains cas, vous pouvez l'utiliser comme réglage du pilote, par exemple pour de meilleures performances ou pour la fixation de la structure.

Paramètres principaux
Paramètre La description
Le pilote prend en charge les index Le pilote prend en charge les index de table
Le pilote prend en charge le code stocké Si ce pilote prend en charge le code stocké (procédures, fonctions, packages, etc.)
Le pilote prend en charge les références Le pilote prend en charge les références de table (clés étrangères)
Le pilote prend en charge la clause SELECT count (*) Le pilote prend en charge la clause SELECT count (*)
Procédures et fonctions divisées Afficher les procédures et les fonctions dans différents dossiers
Délimiteur de script Littéral pour la séparation des requêtes SQL dans les scripts
Redéfinisseur de délimiteur de script Clause SQL qui redéfinit la valeur du délimiteur de script
Utiliser le délimiteur de script après la requête Conserver le délimiteur de script SQL après chaque requête SQL
Utiliser le délimiteur de script après le bloc SQL Conserver le délimiteur de script SQL après les blocs de script SQL (BEGIN / END)
Caractère d'échappement de chaîne Caractère utilisé pour échapper aux symboles spéciaux dans les chaînes
Type de modèle méta Type de modèle de lecture des métadonnées – standard ou indexé
Motif de tous les objets Modèle SQL pour tous les objets de métadonnées
Omettre le (s) catalogue (s) Ne pas lire et utiliser les informations du catalogue (aka base de données)
Omettre un seul catalogue Masquer le catalogue (base de données) s'il n'y a qu'un seul catalogue sur le serveur
Omettre un schéma unique Masquer le schéma s'il n'y a qu'un seul schéma sur le serveur
Omettre le cache de type N'utilisez pas les types de données fournis par le pilote
Paramètre d'arrêt Paramètre URL d'arrêt de la base de données
Créer un paramètre de base de données Paramètre URL de création de base de données
Le pilote prend en charge plusieurs résultats Le pilote prend en charge plusieurs résultats pour une seule requête
Le pilote prend en charge la limite de jeu de résultats Le pilote prend en charge la limite de jeu de résultats multiples (lignes max.)
Le pilote prend en charge le cache de structure Le pilote prend en charge la lecture du cache de structure. Active les colonnes de schéma, les clés, etc.
Le pilote prend en charge l'opération TRUNCATE Le pilote prend en charge la commande TRUNCATE. C'est beaucoup plus rapide que SUPPRIMER sans critère
Requêtes (requêtes de pilote personnalisées)
Paramètre La description
Obtenir une base de données active Requête pour obtenir le nom de la base de données active
Définir la base de données active Requête pour changer la base de données active
Base de données d'arrêt Requête pour arrêter la connexion à la base de données active. Utilisé pour certaines bases de données intégrées
Requête PING Requête pour vérifier l'état de la connexion
Nom de table double Nom de la table factice «DUAL» utilisée pour l'évaluation des expressions
Type d'objet actif Type d'objet sélectionnable (schéma, catalogue)
Le pilote prend en charge le défilement des résultats Le pilote prend en charge le défilement des résultats
Citer les mots réservés Citez les noms de colonnes / tables s'ils sont en conflit avec des mots clés SQL réservés
Échapper aux masques COMME dans les requêtes de recherche Utilisez pour accéder à l'API de métadonnées JDBC. Activé par défaut mais doit être désactivé pour certains pilotes (cassés)
DDL (options de génération DDL)
Paramètre La description
Supprimer la syntaxe courte de la colonne Utilisez 'ALTER TABLE DROP nom_colonne' au lieu de la syntaxe standard
Utiliser le dialecte SQL hérité pour DDL Utiliser le dialecte SQL hérité pour DDL
Formatage (formats de valeurs SQL)
Paramètre La description
Format d'horodatage Modèle de format pour les colonnes d'horodatage
Format de date Modèle de format pour les colonnes de date
Format de l'heure Modèle de format pour les colonnes de temps

Résumé

Si vous avez configuré un pilote, cela fonctionne bien et vous pensez qu'il est logique d'avoir cette configuration de pilote dans DBeaver standard, veuillez nous envoyer votre configuration. Créez simplement un problème de demande de fonctionnalité sur GitHub et copiez / collez la description du pilote sur le ticket (sous toute forme appropriée).

Merci 🙂

Commentaires

Laisser un commentaire

Votre commentaire sera révisé par les administrateurs si besoin.