Connecteur Amazon Athena

Modifié par Aurelie Bertrand le 2025/02/18 17:11

Pré-requis

Avoir le pilote JDBC Athena sous la forme d'un ou plusieurs fichiers JAR et sa documentation.

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

Installation

Déploiement des fichiers

  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
  2. Arrêtez le serveur.
  3. 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.
    Supprimez ainsi les fichiers suivants :
    • httpclient-4.5.xx.jar
    • httpcore-4.4.xx.jar
    • slf4j-api-x.x.xx.jar.
  4. Copiez les fichiers JAR restants dans les dossiers suivants :
    /home/digdash/webapps/default/ddenterpriseapi/WEB-INF/lib
    /home/digdash/webapps/default/studio/WEB-INF/lib
  5. Le pilote JDBC Athena doit maintenant être enregistré dans DigDash Enterprise Serveur.

Enregistrement du pilote JDBC Athena

Pour enregistrer le pilote :

  1. Éditez le fichier suivant :
    <DD Install>/apache-tomcat/webapps/ddenterpriseapi/WEB-INF/classes/resources/config/sqldriverrepository.xml
  2. Ajoutez une entrée XML au fichier sqldriverrepository.xml, qui ressemble à l'exemple suivant :
        <SQLDriver id="ATHENA"
                       name="AWS Athena"
                       url="athena://"
                       manufacturer="Amazon Web Services"
                       class="com.amazon.athena.jdbc.AthenaDriver"
                       urlsample="jdbc:athena://"
                       availability="both">
               <properties></properties>
       </SQLDriver>

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.

Correspondances XML :

  • & => &amp;
  • " => &quot;
  • < => &lt;
  • > => &gt;

Exemple :

  • (FAUX) urlsample="jdbc:mydriver:dbtest?opt1=0&opt2="value""
  • (VRAI) urlsample="jdbc:mydriver:dbtest?opt1=0&amp;opt2=&quot;value&quot;"

Paramètres :

  • id : un identifiant utilisé de manière interne par DigDash Enterprise, choisir une chaîne non existante, par convention en majuscule, sans espace
  • name : Le nom du pilote JDBC affiché dans l'interface de la console d'administration
  • url : Le préfixe de l'URL du pilote JDBC (sans "jdbc:"). Consulter la documentation fournie avec le pilote JDBC
  • manufacturer : Le nom du vendeur/développeur du pilote JDBC
  • class: chemin de la classe java principale du pilote. Consulter la documentation fournie avec le pilote JDBC.
    Optionnel: Les pilotes JDBC de norme JDBC 4 n'ont pas besoin de la classe java pour être pris en compte.
  • urlsample : Exemple d'URL affiché dans l'interface de la console d'administration
  • availability : réservé. Laisser à "both".

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.

Propriétés spécifiques avancées

Consultez la page Ajout Pilote JDBC pour en savoir plus.

Configurer la connexion à la base de données

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 en utilisant les éléments suivants :

  1. Dans la liste déroulante Type de base de données, sélectionnez SQL.
  2. Dans la liste déroulante Pilote JDBC, sélectionnez AWS Athena.
  3. Sépcifiez l'URL sous la forme suivante:
    jdbc:athena://WorkGroup=xxx;Region=xxx;AccessKeyId=xxx;SecretAccessKey=xxx;
  4. 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.