Documentation

This document in English.

version 484

Introduction:

juda est une version amélioré de Trino.
C’est l’une des améliorations que j’ai déjà pu apporter à certains logiciels.

juda est le résultat de la fusion des pull requests suivantes :

Son code source est rassemblé dans le PR juda (Java Unified Database Access).

Associé à LibreOffice Base et jdbcDriverOOo, il permet d’exécuter des requêtes sur des tables provenant de différentes bases de données. Il est même possible de modifier ces tables au sein des grilles de données affichées dans Base.

Etant un logiciel libre je vous encourage:

A dupliquer son code source.
A apporter des modifications, des corrections, des améliorations.
D’ouvrir un dysfonctionnement si nécessaire.
De participer au frais de la certification CASA.

Bref, à participer au developpement de cette extension.
Car c’est ensemble que nous pouvons rendre le Logiciel Libre plus intelligent.

Prérequis:

Le serveur juda est écrit en Java.
Son utilisation nécessite l’installation d’un JRE ou JDK Java version 25 ou ultérieure.
Je vous recommande Adoptium comme source d’installation de Java.

Le serveur juda est une application conteneurisée avec Docker.
Il est donc nécessaire que Docker soit déjà installé.

Installation:

Télécharger le fichier trino-server-484-SNAPSHOT

Puis décompresser ce fichier dans le répertoire de votre choix.
Et enfin, copiez le contenu du dossier trino-server-484-SNAPSHOT du dépôt vers le dossier correspondant dans le répertoire choisi.

Utilisation:

Si nécessaire, dans le fichier de configuration docker-compose.yml, le nom de l’image Docker pour le coordinateur (trino:484-SNAPSHOT-amd64) doit être adaptée à votre architecture.

Les catalogues pris en charge par le serveur sont définis par les fichiers .properties situés dans le dossier:
trino-server-484-SNAPSHOT/etc/catalog.
Des exemples de fichiers .properties sont fournis dans le dossier racine du dépôt.

Ces fichiers sont configurés avec les paramètres par défaut spécifiques à chaque base de données.
Toutefois, si vous souhaitez utiliser le connecteur SQLite, vous devez modifier le paramètre connection-url pour qu’il pointe vers votre fichier ou, du moins, vers un dossier existant.
Pour les autres connecteurs, le dépôt dockerDB permet de mettre en place une base de données très rapidement, sans aucune dépendance autre que Docker.

Pour contrôler le serveur, vous devez vous rendre dans le répertoire: trino-server-484-SNAPSHOT/bin et saisir les commandes suivantes:

Démarrer le serveur : ./launcher run
Arrêter le serveur : ./launcher stop

Si le serveur juda s’exécute sur la même machine:

Pour vous connecter au serveur, vous devez utiliser l’URL suivante:
- Pour une connexion en dehors de LibreOffice: jdbc:trino://localhost:8080
- Pour une connexion via LibreOffice Base: //localhost:8080, après avoir sélectionné Juda pure Java comme type de source de données.
L’activité du serveur peut être surveillée à l’aide d’un navigateur à l’adresse: localhost:8080.

Historique:

Ce qui a été fait pour la version 484:

Le projet juda 484 a nécessité plus de six mois de travail et l’ajout de près de 30 000 lignes de code à Trino afin d’en faciliter l’utilisation.
L’essentiel de ce travail est visible à travers les diverses demandes de tirage (PR) ajoutées au dépôt Trino.