Comment connecter LibreOffice Base à une base de données PostgreSQL

LibreOffice Base peut servir d'interface pour une base de données PostgreSQL existante. Vous pouvez ainsi parcourir les tables, créer des requêtes et générer des formulaires ou des rapports sans déplacer les données vers une base de données Base intégrée. Pour la plupart des installations actuelles, la solution la plus simple est la connexion directe de LibreOffice à PostgreSQL. JDBC reste utile comme solution de repli lorsque votre environnement requiert un pilote Java ou lorsque le connecteur direct est indisponible.

Scénario illustratif : imaginez une petite équipe d’intervention appelée Northwind Field Services. Son serveur PostgreSQL contient une base de données nommée ` <nom_de_la_base_de_données>` sales_ops. Cette base de données est hébergée sur `<adresse_serveur>` db.example.internal, écoute sur le port `<port>` , et l’équipe dispose d’un rôle en lecture seule nommé `<nom_de_l’utilisateur>`. Cet exemple est fictif et sert uniquement à illustrer la cohérence des choix de configuration.5432analyst_ro

Les étapes ci-dessous suivent l'aide actuelle de LibreOffice concernant les connexions PostgreSQL et JDBC, ainsi que la documentation serveur actuelle de PostgreSQL. En octobre 2026, LibreOffice indiquait que la version 26.8.0 était la plus récente et la version 26.2.6 la précédente, stable ; l'emplacement exact des libellés et des boutons peut légèrement varier selon le système d'exploitation et la version. Consultez les notes de version officielles de LibreOffice et l'aide relative à la connexion PostgreSQL pour connaître la terminologie en vigueur.

Avant de commencer : Rassemblez les quatre valeurs de connexion

Vous avez généralement besoin de quatre informations de la part de l'administrateur PostgreSQL :

• Nom de la base de données , par exemplesales_ops : .
• Nom du serveur ou adresse IP , par exempledb.example.internal : .
• Le port , généralement 5432sauf si l'administrateur l'a modifié.
• Identifiants de connexion à PostgreSQL et leur méthode d'authentification ou mot de passe.

Ne présumez pas qu'un serveur acceptant les connexions PostgreSQL locales acceptera également une connexion LibreOffice depuis un autre ordinateur. PostgreSQL listen_addressescontrôle les interfaces réseau autorisées pour les connexions TCP/IP, tandis que pg_hba.confses paramètres de connexion déterminent les adresses IP des clients, les bases de données, les utilisateurs et les méthodes d'authentification autorisés. PostgreSQL documente ces deux comportements dans sa documentation relative aux paramètres de connexion et à l'authentification des clients .

Étape 1 : Ouvrez Base et choisissez une base de données PostgreSQL existante

Lancez LibreOffice Base et créez un nouveau document de base de données. Dans l'Assistant Base de données, choisissez « Se connecter à une base de données existante » , puis sélectionnez PostgreSQL comme type de base de données. L'Assistant Base de données de LibreOffice permet de connecter un document Base à une base de données existante plutôt que d'en créer une nouvelle.

Légende : L’assistant de base de données est configuré pour se connecter à une base de données PostgreSQL existante plutôt que de créer une nouvelle base de données embarquée.

Dans l'exemple de Northwind Field Services, cela signifie que Base stockera les informations de connexion et les objets Base tels que les requêtes, les formulaires et les rapports, tandis que les tables métiers proprement dites resteront dans PostgreSQL.

Étape 2 : Saisissez le nom de la base de données, le serveur et le port

Sur la page de connexion PostgreSQL, saisissez le nom de la base de données, le serveur et le port fournis par votre administrateur. Dans l'exemple en cours, ces valeurs sont : sales_ops, db.example.internal, et 5432.

Légende : Page de connexion directe à PostgreSQL avec l’exemple de nom de base de données, de serveur et de port PostgreSQL par défaut.

LibreOffice permet également d'utiliser une chaîne de connexion spécifique à PostgreSQL au lieu de renseigner les champs de base. L'aide officielle présente des exemples tels que `<PostgreSQL>` dbname=MyDatabase host=myHost port=5432et `<PostgreSQL>` postgresql://myHost:port/MyDatabase. Cela peut s'avérer utile lorsqu'un administrateur vous fournit des paramètres supplémentaires spécifiques au pilote. LibreOffice précise que les valeurs `<PostgreSQL>` user=et password=`<PostgreSQL>` dans cette chaîne de connexion sont ignorées et qu'une authentification est requise lors de la connexion.

Étape 3 : Saisissez l’utilisateur PostgreSQL et testez la connexion.

Saisissez le rôle PostgreSQL à utiliser depuis Base. Un compte en lecture seule ou disposant des privilèges minimaux est généralement plus sûr qu'un compte propriétaire de base de données ou un superutilisateur pour la génération de rapports ou l'analyse. Dans cet exemple, le rôle est : analyst_ro.

Légende : L’authentification est configurée avec le rôle en lecture seule d’exemple et le test de connexion signale une réussite.

Effectuez un test de connexion avant d'enregistrer le document Base. Un test réussi confirme que Base peut accéder au serveur et s'authentifier avec le rôle fourni. Toutefois, cela ne garantit pas que ce rôle dispose des autorisations de lecture pour toutes les tables que vous prévoyez d'utiliser ; il est donc nécessaire de vérifier la visibilité des tables après l'établissement de la connexion.

En cas d'échec du test, conservez le message exact. Les erreurs telles que `<erreur> no pg_hba.conf entry`, password authentication failed`<erreur> user does not exist`, `<erreur>` ou ` <erreur>` ont des causes différentes. La page de dépannage de l'authentificationdatabase does not exist de PostgreSQL explique ces messages et recommande de consulter le journal du serveur lorsque l'erreur côté client ne suffit pas.

Étape 4 : Enregistrer le document de base de données

Une fois le test réussi, choisissez d'enregistrer la base de données dans LibreOffice et de l'ouvrir immédiatement pour modification. L'enregistrement est utile lorsque d'autres composants de LibreOffice doivent accéder à la source de données par son nom. Cliquez ensuite sur Terminer et enregistrez le document de base .odb.

Légende : La dernière page de l’assistant permet d’enregistrer la source de données PostgreSQL et d’ouvrir le document Base enregistré pour modification.

Dans cette configuration, ce .odbfichier ne constitue pas une copie de la base de données PostgreSQL. Considérez-le comme le document de base de données côté LibreOffice contenant la définition de connexion et les objets de base. Si vous déplacez ce .odbfichier sur un autre ordinateur, ce dernier devra toujours disposer d'un accès réseau, d'identifiants valides et des pilotes ou certificats requis.

Étape 5 : Vérifier que les tableaux attendus sont visibles

Ouvrez le document Base enregistré et sélectionnez Tables . Vous devriez voir les objets auxquels le rôle PostgreSQL est autorisé à accéder. Dans l'exemple fictif, les tables attendues pourraient inclurecustomers : , orders, products, et order_items.

Légende : La vue des tables de base est le premier contrôle pratique permettant de vérifier que le rôle PostgreSQL connecté peut voir les objets de schéma attendus.

Si la connexion réussit mais que des tables sont manquantes, il ne s'agit généralement plus d'un problème réseau. Vérifiez les privilèges du rôle PostgreSQL, la visibilité des schémas et le chemin de recherche des schémas. Avant de modifier vous-même les autorisations, demandez à l'administrateur de la base de données quels schémas et objets le compte est censé voir.

Étape 6 : Exécutez une petite requête en lecture seule avant de créer des formulaires ou des rapports

Avant de créer une solution de base plus importante, exécutez une simple requête en lecture seule sur une petite table. Par exemple :

SELECT customer_id, full_name, city
FROM customers
ORDER BY full_name;

Légende : Une petite requête SELECT permet de vérifier le bon fonctionnement des tables PostgreSQL une fois qu’elles sont visibles dans Base.

Ce test vérifie davantage que la simple connexion initiale : il s’assure que Base peut exécuter des requêtes SQL via la connexion, que le rôle a les droits de lecture sur l’objet cible et que les lignes renvoyées sont utilisables dans l’interface de requêtes de Base. Commencez par SELECTdes instructions si vous validez une base de données de production. N’effectuez aucun test en insérant, mettant à jour ou supprimant des enregistrements réels, sauf si cela fait explicitement partie de vos exigences d’accès.

Étape 7 : Configurer TLS lorsque la stratégie de base de données exige le chiffrement

Pour une base de données distante ou de production, respectez les exigences TLS de votre organisation et n'acceptez pas une connexion non chiffrée. PostgreSQL prend en charge les connexions client/serveur chiffrées lorsque SSL est activé sur le serveur, et les administrateurs peuvent définir des règles d'hôte spécifiques à SSL pg_hba.conf. La documentation officielle de PostgreSQL relative à SSL/TLS fournit des informations détaillées sur la configuration .

La connexion directe de LibreOffice à PostgreSQL accepte des paramètres de connexion spécifiques au pilote, mais tous les paramètres de connexion PostgreSQL ne sont pas nécessairement gérés par le gestionnaire de pilotes de LibreOffice. Si vous avez besoin d'une vérification de certificat, de certificats clients ou d'un mode SSL spécifique, veuillez confirmer la chaîne de connexion exacte auprès de votre administrateur de base de données et consulter la documentation de LibreOffice pour votre version installée. Dans ce cas, copier une chaîne de connexion Internet générique peut donner une fausse impression de sécurité.

Légende : Une erreur d’authentification mentionnant pg_hba.conf et l’état SSL indique un problème de politique de connexion côté serveur, et non une simple erreur de frappe dans le nom du document Base.

Étape 8 : Utilisez JDBC uniquement lorsque vous avez besoin du chemin d’accès au pilote Java

Si l'option PostgreSQL directe n'est pas disponible dans votre environnement ou si un administrateur a spécifié l'utilisation de JDBC, Base peut se connecter via un pilote JDBC. Cette méthode nécessite l'installation de Java et d'un pilote ; il est donc préférable de la considérer comme une alternative plutôt que comme une condition préalable à toute connexion PostgreSQL.

Téléchargez le pilote JDBC PostgreSQL uniquement depuis le site officiel de pgJDBC . La documentation de pgJDBC précise que le fichier JAR du pilote doit figurer dans le chemin de classe Java. L'aide JDBC de LibreOffice indique aux utilisateurs d'ajouter le chemin du pilote via Outils > Options > LibreOffice > Avancé > Chemin de classe , puis de redémarrer LibreOffice.

Légende : Le basculement JDBC nécessite un environnement d’exécution Java et le fichier JAR JDBC PostgreSQL dans le chemin de classe de LibreOffice.

Pour PostgreSQL, pgJDBC documente les URL sous la forme `<URL>` jdbc:postgresql://host:port/database. Avec le serveur fictif, cela donnerait `<URL>` jdbc:postgresql://db.example.internal:5432/sales_ops. La classe du pilote JDBC PostgreSQL est org.postgresql.Driver`<pilote>`. Les applications Java modernes peuvent la charger via le mécanisme de fournisseur de services Java lorsque le fichier JAR est présent, bien que l'assistant JDBC de LibreOffice puisse encore demander une valeur pour la classe du pilote. Consultez le guide d'installation de pgJDBC , la documentation sur les URL de connexion pgJDBC et l'aide JDBC de LibreOffice .

Tableau de dépannage rapide

À quoi devrait ressembler une installation réussie

Un critère de réussite utile ne se limite pas à la réussite du test de connexion. Dans l'exemple de Northwind Field Services, la configuration est véritablement prête lorsque le document Base se rouvre correctement, que le analyst_rocompte ne peut voir que les objets PostgreSQL prévus, qu'une petite SELECTrequête renvoie les lignes attendues et que la connexion répond aux exigences de chiffrement et d'authentification de l'organisation.

Si les requêtes de base fonctionnent correctement, mais que des formulaires ou rapports Base plus complexes présentent des limitations liées au type de données, aux performances ou au pilote, cessez de considérer le problème comme un simple problème de connectivité. À ce stade, comparez le connecteur PostgreSQL direct avec JDBC pour la charge de travail concernée et testez précisément la requête ou le type de données pertinent. La méthode de connexion doit être adaptée à la politique de la base de données et aux fonctionnalités Base que vous utilisez réellement, et non devenir une fin en soi.