Código fuente wiki de Connecteur Amazon Athena

Última modificación por Aurelie Bertrand el 2026/01/12 15:14
Mostrar los últimos autores
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. Dézippez l'archive Athena précédemment téléchargée.
18 1. Certains fichiers contenus dans l'archive sont déjà livrés avec Digdash dans une version différente qui entre en conflit avec le pilote.
19 Supprimez ainsi les fichiers suivants du dossier **runtime-dependencies** :
20 1*. //httpclient-4.5.xx.jar//
21 1*. //httpcore-4.4.xx.jar//
22 1*. //slf4j-api-x.x.xx.jar//
23 1. Copiez :
24 ✔ les fichiers JAR restants dans le dossier **runtime-dependencies**
25 ✔ le fichier //athena-jdb-3.1.x.jar //présent à la racine de l'archive dézippée
26 vers les dossiers **/home/digdash/webapps/default/ddenterpriseapi/WEB-INF/lib **et **/home/digdash/webapps/default/studio/WEB-INF/lib**.
27 1. Le pilote JDBC Athena doit maintenant être enregistré dans DigDash Enterprise Server.
28
29 == Enregistrement du pilote JDBC Athena ==
30
31 Pour enregistrer le pilote :
32
33 1. Éditez le fichier suivant :
34 **<DD Install>/webapps/ddenterpriseapi/WEB-INF/classes/resources/config/sqldriverrepository.xml**
35 1. Ajoutez une entrée XML au fichier **sqldriverrepository.xml**, qui ressemble à l'exemple suivant :
36
37 {{code cssClass="notranslate" language="xml"}}
38 <SQLDriver id="ATHENA"
39 name="AWS Athena"
40 url="athena://"
41 manufacturer="Amazon Web Services"
42 class="com.amazon.athena.jdbc.AthenaDriver"
43 urlsample="jdbc:athena://"
44 availability="both">
45 <properties></properties>
46 </SQLDriver>
47 {{/code}}
48
49 (% class="box warningmessage" %)
50 (((
51 //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.//
52 )))
53
54 Correspondances XML :
55
56 * **&** => **&amp;**
57 * **"** => **&quot;**
58 * **<** => **&lt;**
59 * **>** => **&gt;**
60
61 Exemple :
62
63 * (FAUX) urlsample="jdbc:mydriver:dbtest?opt1=0&opt2="value""
64 * (VRAI) urlsample="jdbc:mydriver:dbtest?opt1=0&amp;opt2=&quot;value&quot;"
65
66 Paramètres :
67
68 * **id **: un identifiant utilisé de manière interne par DigDash Enterprise, choisir une chaîne non existante, par convention en majuscule, sans espace
69 * **name **: Le nom du pilote JDBC affiché dans l'interface de la console d'administration
70 * **url **: Le préfixe de l'URL du pilote JDBC (sans "jdbc:"). Consulter la documentation fournie avec le pilote JDBC
71 * **manufacturer **: Le nom du vendeur/développeur du pilote JDBC
72 * **class**: chemin de la classe java principale du pilote. Consulter la documentation fournie avec le pilote JDBC.
73 //Optionnel: Les pilotes JDBC de norme JDBC 4 n'ont pas besoin de la classe java pour être pris en compte.//
74 * **urlsample **: Exemple d'URL affiché dans l'interface de la console d'administration
75 * **availability **: réservé. Laisser à "both".
76
77 (% class="box warningmessage" %)
78 (((
79 //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.//
80 )))
81
82 == Propriétés spécifiques avancées ==
83
84 Consultez la page [[Ajout Pilote JDBC>>doc:Digdash.deployment.Connectivity_Database.adding_jdbc_driver.WebHome||anchor="advanced_prop"]] pour en savoir plus.
85
86 = Configurer la connexion à la base de données =
87
88 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 :
89
90 1. Dans la liste déroulante **Type **de base de données, sélectionnez **SQL**.
91 1. Dans la liste déroulante **Pilote JDBC**, sélectionnez **AWS Athena**.
92 1. Sépcifiez l'**URL **sous la forme suivante:
93 //jdbc:athena:~/~/WorkGroup=**xxx**;Region=**xxx**;AccessKeyId=**xxx**;SecretAccessKey=**xxx**;//
94 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.