Code source wiki de Connecteur Amazon Athena

Modifié par Aurelie Bertrand le 2025/02/18 17:11
Afficher les derniers auteurs
1 {{ddtoc}}{{/ddtoc}}
2
3 ----
4
5 = Pré-requis =
6
7 Avoir le pilote JDBC Athena sous la forme d'un ou plusieurs fichiers JAR et sa documentation.
8
9 Digdash est compatible seulement avec la version 3.1.0 du pilote JDBC Athena. Vous pouvez la télécharger en utilisant ce lien : [[https:~~/~~/downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.1.0/athena-jdbc-3.1.0-lean-jar-and-separate-dependencies-jars.zip>>https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.1.0/athena-jdbc-3.1.0-lean-jar-and-separate-dependencies-jars.zip]]
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. Certains fichiers contenus dans le dossier téléchargé sont déjà livrés avec Digdash dans une version différente qui entre en conflit avec le pilote.
18 Supprimez ainsi les fichiers suivants :
19 1*. httpclient-4.5.xx.jar
20 1*. httpcore-4.4.xx.jar
21 1*. slf4j-api-x.x.xx.jar.
22 1. Copiez les fichiers JAR restants dans les dossiers suivants :
23 **/home/digdash/webapps/default/ddenterpriseapi/WEB-INF/lib
24 /home/digdash/webapps/default/studio/WEB-INF/lib**
25 1. Le pilote JDBC Athena doit maintenant être enregistré dans DigDash Enterprise Serveur.
26
27 == Enregistrement du pilote JDBC Athena ==
28
29 Pour enregistrer le pilote :
30
31 1. Éditez le fichier suivant :
32 **<DD Install>/apache-tomcat/webapps/ddenterpriseapi/WEB-INF/classes/resources/config/sqldriverrepository.xml**
33 1. Ajoutez une entrée XML au fichier **sqldriverrepository.xml**, qui ressemble à l'exemple suivant :
34
35 {{code cssClass="notranslate" language="xml"}}
36 <SQLDriver id="ATHENA"
37 name="AWS Athena"
38 url="athena://"
39 manufacturer="Amazon Web Services"
40 class="com.amazon.athena.jdbc.AthenaDriver"
41 urlsample="jdbc:athena://"
42 availability="both">
43 <properties></properties>
44 </SQLDriver>
45 {{/code}}
46
47 (% class="box warningmessage" %)
48 (((
49 //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.//
50 )))
51
52 Correspondances XML :
53
54 * **&** => **&amp;**
55 * **"** => **&quot;**
56 * **<** => **&lt;**
57 * **>** => **&gt;**
58
59 Exemple :
60
61 * (FAUX) urlsample="jdbc:mydriver:dbtest?opt1=0&opt2="value""
62 * (VRAI) urlsample="jdbc:mydriver:dbtest?opt1=0&amp;opt2=&quot;value&quot;"
63
64 Paramètres :
65
66 * **id **: un identifiant utilisé de manière interne par DigDash Enterprise, choisir une chaîne non existante, par convention en majuscule, sans espace
67 * **name **: Le nom du pilote JDBC affiché dans l'interface de la console d'administration
68 * **url **: Le préfixe de l'URL du pilote JDBC (sans "jdbc:"). Consulter la documentation fournie avec le pilote JDBC
69 * **manufacturer **: Le nom du vendeur/développeur du pilote JDBC
70 * **class**: chemin de la classe java principale du pilote. Consulter la documentation fournie avec le pilote JDBC.
71 //Optionnel: Les pilotes JDBC de norme JDBC 4 n'ont pas besoin de la classe java pour être pris en compte.//
72 * **urlsample **: Exemple d'URL affiché dans l'interface de la console d'administration
73 * **availability **: réservé. Laisser à "both".
74
75 (% class="box warningmessage" %)
76 (((
77 //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.//
78 )))
79
80 == Propriétés spécifiques avancées ==
81
82 Consultez la page [[Ajout Pilote JDBC>>doc:Digdash.deployment.Connectivity_Database.adding_jdbc_driver.WebHome||anchor="advanced_prop"]] pour en savoir plus.
83
84 = Configurer la connexion à la base de données =
85
86 Pour configurer la connexion à la base de données, procédez comme décrit sur la page [[Gestionnaire des connexions aux bases de données>>doc:Digdash.user_guide.studio.managers.dbconnections.WebHome]] en utilisant les éléments suivants :
87
88 1. Dans la liste déroulante **Type **de base de données, sélectionnez **SQL**.
89 1. Dans la liste déroulante **Pilote JDBC**, sélectionnez **AWS Athena**.
90 1. Sépcifiez l'**URL **sous la forme suivante:
91 //jdbc:athena:~/~/WorkGroup=**xxx**;Region=**xxx**;AccessKeyId=**xxx**;SecretAccessKey=**xxx**;//
92 1. L'utilisateur et le mot de passe sont déjà renseignés dans l'URL. Il n'est donc pas nécessaire de les renseigner.