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).

Grâce à ces modifications, le serveur juda est un serveur Trino qui prend en charge:

Des identifiants sensibles à la casse.
Des ensembles de résultats (ResultSets) fournissant les métadonnées suivantes:
- Nom du catalogue.
- Nom du schéma.
- Nom de la table.
- Indication si la colonne est en auto-incrémentation.
- Indication si la colonne est en lecture seule.
3 connecteurs supplémentaires:
- HyperSQL.
- Firebird.
- SQLite.

Libéré de ces limitations et combiné à LibreOffice Base et jdbcDriverOOo, il permet d’exécuter des requêtes sur des tables issues 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 JDK Java version 25 ou ultérieure.
Je vous recommande Adoptium comme source d’installation de Java.

Le serveur Trino (et donc juda) ne peut fonctionner que sous Linux ou Darwin.

Si vous utilisez Windows, il est toujours possible d’installer Linux sur Windows avec WSL.
Et à condition d’installer le JDK Java dans votre environnement Linux, cela fonctionnera, même si les performances ne seront pas optimales.

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:

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.

Sinon, remplacez localhost par l’adresse IP du serveur juda.

Attention: Bien qu’un nom d’utilisateur doive être fourni lors de la connexion (il peut être n’importe quelle valeur), aucune authentification n’est configurée sur le serveur juda.
Il vous incombe de configurer une authentification sur le serveur juda afin de garantir la sécurité des connecteurs du serveur.

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 de le rendre utilisable dans LibreOffice Base.
L’essentiel de ce travail est visible à travers les diverses demandes de tirage (PR) ajoutées au dépôt Trino.