Code source wiki de Ajout Pilote JDBC

Modifié par jhurst le 2021/04/21 10:01
Afficher les derniers auteurs
1 {{ddtoc}}{{/ddtoc}}
2
3 ----
4
5 Ce document décrit la procédure d'ajout d'un nouveau pilote JDBC dans DigDash Enterprise.
6
7 = Pré-requis =
8
9 Avoir le pilote JDBC sous la forme d'un ou plusieurs fichiers JAR et sa documentation. [[Propriétés spécifiques avancées>>||anchor="HPropriE9tE9sspE9cifiquesavancE9es"]]
10
11 = Installation =
12
13 == Déploiement des fichiers ==
14
15 1. //(optionnel, si les webapps n'ont pas encore été déployées). //Démarrez le serveur DigDash Enterprise et attendre le déploiement complet des webapps
16 1. Arrêtez le serveur
17 1. Copiez le ou les fichiers JAR du pilote JDBC dans les dossiers suivants :
18 **<DD Install>/apache-tomcat/webapps/ddenterpriseapi/WEB-INF/lib**
19 **<DD Install>/apache-tomcat/webapps/studio/WEB-INF/lib**
20 1. Le pilote JDBC doit maintenant être enregistré dans DigDash Enterprise Serveur.
21
22 == Enregistrement du pilote JDBC ==
23
24 Pour cela éditez le fichier suivant :
25
26
27 **<DD Install>/apache-tomcat/webapps/ddenterpriseapi/WEB-INF/classes/resources/config/sqldriverrepository.xml**
28
29 Ajoutez une entrée XML au fichier **sqldriverrepository.xml**, qui ressemble à l'exemple suivant :
30
31 {{code language="xml"}}
32 <SQLDriver id="MY_DRIVER"
33 name="My Driver"
34 url="mydriver:"
35 manufacturer="My Driver Company"
36 class="com.mydriver.MyDriver"
37 urlsample="jdbc:mydriver:<database>?<options>"
38 availability="both">
39 <properties></properties>
40 </SQLDriver>
41 {{/code}}
42
43 (% class="box warningmessage" %)
44 (((
45 //Important : Certains caractères sont réservés en XML : '**&**', '**"**', '**<**' or '**>**'. Donc si vous utilisez certains de ces caractères, assurez-vous de les encoder vers leur entités XML correspondantes.//
46 )))
47
48 Correspondances XML :
49
50 * **&** => **&amp;**
51 * **"** => **&quot;**
52 * **<** => **&lt;**
53 * **>** => **&gt;**(((
54 Exemple :
55 )))
56
57 * (FAUX) urlsample="jdbc:mydriver:dbtest?opt1=0&opt2="value""
58 * (VRAI) urlsample="jdbc:mydriver:dbtest?opt1=0&amp;opt2=&quot;value&quot;"
59
60 Paramètres :
61
62 * **id **: un identifiant utilisé de manière interne par DigDash Enterprise, choisir une chaîne non existante, par convention en majuscule, sans espace
63 * **name **: Le nom du pilote JDBC affiché dans l'interface de la console d'administration
64 * **url **: Le préfixe de l'URL du pilote JDBC (sans "jdbc:"). Consulter la documentation fournie avec le pilote JDBC
65 * **manufacturer **: Le nom du vendeur/développeur du pilote JDBC
66 * **class**: chemin de la classe java principale du pilote. Consulter la documentation fournie avec le pilote JDBC.
67 //Optionnel: Les pilotes JDBC de norme JDBC 4 n'ont pas besoin de la classe java pour être pris en compte.//
68 * **urlsample **: Exemple d'URL affiché dans l'interface de la console d'administration
69 * **availability **: réservé. Laisser à "both".
70
71 (% class="box warningmessage" %)
72 (((
73 //Important : Le déploiement est perdu lorsque vous mettez à jour le fichier ddenterpriseapi.war. Suivre cette procédure de déploiement du pilote à chaque fois que vous mettez DigDash Enterprise à jour.//
74 )))
75
76 Dans le fichier **sqldriverrepository.xml** il y a quelques exemples de XML pour des pilotes non fournis avec DigDash.
77
78 == Propriétés spécifiques avancées ==
79
80 Il est possible de spécifier des propriétés spécifiques pour certains pilotes JDBC. Ces propriétés sont à écrire à l’intérieur du tag <properties></properties> sous la forme :
81
82 {{code language="xml"}}
83 <properties>
84
85 **<property name="nom_propriété" value="valeur_propriété" />**
86
87 <properties>
88 {{/code}}
89
90 Les propriétés supportées sont :
91
92 === FORCE_FORWARD_ONLY (non défini | false | true) ===
93
94 Description : spécifie le type de curseur JDBC utilisé par le Studio pour la prévisualisation des résultats d’une requête SQL. Par défaut le Studio utilise un curseur TYPE_INSENTIVE_SCROLL pour la prévisualisation des résultats, mais certaines bases de données ne le supporte pas. Si votre pilote/BDD ne supporte que les curseurs de TYPE_FORWARD_ONLY, vous pouvez le spécifier avec le propriété FORCE_FORWARD_ONLY. Les valeurs possibles sont :
95
96 * **false** (ou **propriété non définie**) : Le type de curseur est automatique, TYPE_SCROLL_INSENTIVE dans la plupart des cas sauf pour HIVE, IMPALA et SAPHANA
97 * **true **: Le type de curseur utilisé par le Studio est TYPE_FORWARD_ONLY
98
99 === PING_SQL (non défini | requête SQL | chaîne vide) ===
100
101 Description : DigDash Enterprise teste la connexion avec la base de données en utilisant la méthode JDBC **Connection.isValid()**. Sur certains drivers JDBC cette méthode ne fonctionne pas. Dans ce cas, DigDash utilise une autre méthode alternative de sélection simple, la plupart du temps une requête « select 1 ».
102
103 La propriété PING_SQL permet de spécifier une requête simple pour tester la connexion à la BDD, en fonction de votre pilote. Les valeurs possibles sont :
104
105 * **Propriété non définie** : La requête de ping alternative est automatiquement déterminée par DigDash Enteprise : « select 1 » sauf dans les cas de pilotes ORACLE, FIREBIRD, SAPHANA, DB2_AS400 et DB2
106 * **requête SQL non vide **: la requête spécifiée sera utilisée pour tester la connexion à la base de données. Exemple :
107 <property name="PING_SQL" value="select 1 from all_tables" />
108 * **chaîne vide **: Cas spécial où on désactive le ping alternatif. Si la méthode JDBC Connection.isValid() échoue, alors on considère quand même la base de données comme accessible. Exemple :
109 \\{{code language="xml"}}<property name="PING_SQL" value="" />{{/code}}
110
111 === USE_FETCH_FIRST_IN_STUDIO (non défini | false | true) ===
112
113 Description : Cette propriété n’est active que pour la prévisualisation du résultat de la requête SQL dans l’écran de configuration de la source de données (Studio). Elle modifie la requête et y ajoute "FETCH FIRST n ROWS ONLY" (n est remplacée par le nombre de lignes de prévisualisation). Elle est utile pour les pilotes qui ne supportent pas la fonctionnalité JDBC **Statement.setMaxRows(n)**, comme par exemple le driver JDBC AS400. Les valeurs possibles sont :
114
115 * **false** (ou **propriété non définie**) : La limite de prévisualisation est spécifiée en utilisant la méthode JDBC **Statement.setMaxRows(n)**
116 * **true **: La limite de prévisualisation est spécifiée en ajoutant FETCH FIRST n ROWS ONLY au SQL dans le Studio.
117
118 === FORBID_POOL_CONNECTION (non défini | false | true) ===
119
120 Description : Interdit l’usage d’un pool de connexions JDBC par le serveur DigDash Enterprise. Un pool de connexion permet d’optimiser les accès à une base de données en laissant les connexions ouvertes et réutilisables pour d’autres requêtes. Dans certains cas il est souhaitable de forcer DigDash Enterprise à ne pas utiliser un pool de connexions JDBC, par exemple pour s’assurer que des connexions ne restent pas ouvertes trop longtemps sur la base de données. Cette propriété répond à ce besoin. Les valeurs possibles sont :
121
122 * **false** (ou **propriété non définie**) : Un pool de connexions JDBC peut être utilisé pour ce pilote
123 * **true **: Le pool de connexions JDBC n’est pas utilisé pour ce pilote et chaque requêtes SQL aura sa propre connexion JDBC indépendante
124
125 === POOL_VALIDATION_QUERY (non défini | requête SQL) ===
126
127 Description : Permet de spécifier une requête de validation utilisée par le pool de connexions JDBC Apache DBCP2. Certains drivers JDBC ne spécifient pas cette requête (ex. « select 1 ») et peuvent donc dysfonctionner lorsqu’ils sont instanciés par le pool de connexions JDBC. Cette propriétés permet de spécifier cette requête de validation. Elle est similaire à la propriété validationQuery configurable via les propriétés du pool Apache DBCP2. Les valeurs possibles sont :
128
129 * **propriété non définie** : Aucune requête de validation spécifique n’est configurée pour ce driver. Le pool utilisera la requête de validation par défaut pour ce driver (s’il en spécifie une)
130 * **requête SQL non vide **: la requête spécifiée sera utilisée pour tester la connexion à la base de données par le pool de connexion Apache DBCP. (Exemple : select 1)
131
132 === DEFAULT_FETCH_SIZE (non défini | chiffre) ===
133
134 Description : Permet de spécifier un nombre de lignes de données maximal par défaut à récupérer en une fois par DigDash Enterprise. Certains drivers JDBC (ex. Postgresql) récupèrent par défaut toutes les lignes d'une requête en une seule fois ce qui peut conduire à une utilisation élevée de mémoire vive et l'impossibilité d'annuler la synchronisation d'une source de données SQL qui utilise un de ces drivers. Ce paramètre permet d'éviter ce cas en spécifiant un nombre plus raisonnable de lignes à récupérer (ex. 100). Par example un DEFAULT_FETCH_SIZE de 1000 récupérera les premières 1000 lignes et lorsque DigDash aura besoin de récupérer la 1001ième ligne, le driver JDBC récupérera les prochaines 1000 lignes. Ce paramètre peut aussi être modifié au niveau d'une source de données de type SQL lors de sa création ou édition dans le studio.