OpenOffice.org Base et MySQL
Il s'agit ici d'utiliser le module base de OpenOffice.org, pour gérer une base de données MySQL.
La configuration
OpenOffice et MySQL sont sur deux machines différentes :
- MySQL : sur une machine d'IP 192.168.1.130 Il s'agit de MySQL 5.0 (Debian GNU/Linux sarge-backports)
- OpenOffice.org : sur une machine du réseau 192.168.1.0 Il s'agit de OpenOffice.org 2.0.3
Le serveur MySQL
La configuration du serveur MySQL ne pose pas de difficulté particulière :
- Installation
$ aptitude install mysql-server
- Mot de passe root
$ mysql -u root mysql> SET PASSWORD FOR 'root' = PASSWORD('PassRoot');
- Création de la base contacts: c'est important, car OpenOffice.org ne permet pas la création de bases. OpenOffice.org accède à des bases existantes.
mysql> CREATE DATABASE contacts; mysql> SHOW DATABASES;
- Création de l'utilisateur user1 + droits sur base contacts : même remarque : pour OpenOffice.org, l'utilisateur doit avoir été créé préalablement.
mysql> GRANT ALL PRIVILEGES ON contacts.* TO 'user1' IDENTIFIED BY 'PassUser1';
- Dernière précaution : permettre l'accès à la base depuis un poste distant, en indiquant à MySQL le nom / l'adresse sur laquelle il doit écouter. Dans notre cas, il s'agit de 192.168.1.30 mais ce pourrait être un domaine pleinement qualifié, ou localhost. Modifier donc
/etc/mysql/my.cnf
:
bind-address = 192.168.1.130
Sur le poste client
Indépendamment de OpenOffice.org, on va d'abord tester l'accès à la base distante, au travers d'un client MySQL
- Installation du client MySQL
aptitude install mysql-client (installe aussi mysql-common).
- Tests de connexion :
mysql -h 192.168.1.130 -u user1 -p contacts Enter password: PassUser1
Tout semble bien se passer :
Reading table information for completion of table and column names You can turn off this feature to get a quicker startup with -A Welcome to the MySQL monitor. Commands end with ; or \g. Your MySQL connection id is 33 to server version: 5.0.24a-Debian_5~bpo.1-log Type 'help;' or '\h' for help. Type '\c' to clear the buffer. mysql>
A partir de là, place à quelques tests d'interrogations de la base
mysql> show databases; +--------------------+ | Database | +--------------------+ | information_schema | | contacts | +--------------------+ 2 rows in set (0.00 sec) .... mysql> quit; Bye
ODBC
Bref, tout va bien, on va maintenant tenter d'accéder à la base, toujours depuis notre poste client, mais via ODBC.
aptitude install libmyodbc (installe aussi unixodbc)
Les fichiers /etc/odbc.ini (fichier vide) et /etc/odbcinst.ini sont créés. odbcinst.ini déclare le driver MySQL ODBC:
[MySQL] Description = MySQL driver Driver = /usr/lib/odbc/libmyodbc.so Setup = /usr/lib/odbc/libodbcmyS.so CPTimeout = CPReuse = FileUsage = 1
On peut maintenant utiliser la commande odbcinst :
# odbcinst -j unixODBC 2.2.4 DRIVERS............: /etc/odbcinst.ini SYSTEM DATA SOURCES: /etc/odbc.ini USER DATA SOURCES..: /root/.odbc.ini
CF man odbcinst pour toutes les options
On peut également utiliser la commande isql (voir plus bas)
Au préalable, il faut initialiser au moins un DSN (Data Source Name ou Data Set Name). En effet, toute connexion ODBC à une base s'initialise au travers d'un DSN existant. Ce sera vrai dans tous les cas, notamment pour initialiser une connexion ODBC depuis OpenOffice.org.
Pour créer une DSN, plusieurs solutions :
- Modifier le fichier /etc/odbc.ini pour tous les utilisateurs du système.
- Modifier le fichier ~/.odbc.ini pour un utilisateur donné.
- Réaliser les modifications depuis une interface graphique ODBCConfig ou gODBCConfig (paquets debian du même nom). Les applications graphiques, au final, modifient les fichiers /etc/odbc.ini ou ~/.odbc.ini
Exemple de fichier /etc/odbc.ini modifié manuellement :
[MySQL-test] Description = Base MySQL ODBC TraceFile = stderr Driver = MySQL SERVER = 192.168.1.130 USER = user1 PASSWORD = DATABASE = contacts
Dans ce cas, le DSN a pour nom MySQL-test
On peut alors tester, grâce à la commande isql : isql MySQL-test user1 PassUser1
+---------------------------------------+ | Connected! | | | | sql-statement | | help [tablename] | | quit | | | +---------------------------------------+ SQL> show databases; +-------------------+ | Database | +-------------------+ | information_schema| | contacts | +-------------------+ 2 rows affected 2 rows returned SQL> quit;
JDBC
On peut aussi accéder à MySQL avec le connecteur JDBC.
aptitude install libmysql-java
Déclarer le connecteur auprès d'OpenOffice.org:
- Outils -> Options -> Java -> Class path...
- Ajouter une archive...
- Sélectionner /usr/share/java/mysql.jar
OpenOffice.org (module Base)
La connexion à la base distante se fait alors simplement, via ODBC, au travers du DSN précédemment configuré :
Fichier -> Nouveau -> Base de données -> Se connecter à une base de données existante -> MYSql -> Suivant -> Connexion utilisant ODBC -> Suivant -> Choisir une source de données -> MySQL-test -> Nom d'utilisateur : user1 + cocher Mot de Passe requis -> Oui je souhaite que l'assistant enregistre la base de données -> Terminer
A ce stade, on est connecté à la base contacts, en tant que user1. Au moment de toucher à la base (par exemple pour créer des tables), il faudra entrer son mot de passe.
Ensuite, tout se passe dans OpenOffice.org
Quelques limitations du module base
Les fonctionnalités suivantes requièrent un environnement JAVA
- assistant de création de formulaire (alors que la création de formulaire en mode ébauche ne nécessite pas de JRE).
- assistant de création de rapport.
- assistant de création de requête (alors que la création de requête en mode ébauche, et la création de requête en vue SQL fonctionnent sans JRE).
- assistant de création de table (alors que la création de table en mode ébauche, et la création de vue fonctionnent sans JRE).
Installez le paquet 'openjdk-6-jre'.
La connexion avec ODBC ne gère apparemment pas les bases en UTF-8 (problèmes d'accents). Elles passent correctement en JDBC.
PostgreSQL
Variante de odbcinst.ini
(cf. /usr/share/psqlodbc/odbcinst.ini.template
):
[PostgreSQL] Description = PostgreSQL driver Driver = /usr/lib/odbc/psqlodbcw.so Setup = /usr/lib/odbc/libodbcpsqlS.so Debug = 0 CommLog = 1
Variante de .odbc.ini
:
[pgtest] Description = Base PostgreSQL ODBC TraceFile = stderr Driver = PostgreSQL SERVERNAME = localhost USERNAME = monutilisateur PASSWORD = monmotdepasse DATABASE = mabasededonnees
HSQLDB
Variante pour une base HSQLDB serveur (autonome, non intégrée):
aptitude install libhsqldb-java
- Ajouter
/usr/share/java/hsqldb.jar
dans Outils -> Options -> Java -> Classpath -> Ajouter une archive - Se connecter via JDBC
- URL: jdbc:
hsqldb:hsql://localhost;default_schema=true
(la partie;default_schema=true
est nécessaire, Base ne permet quasiment rien sans ça) - Classe du pilote ODBC:
org.hsqldb.jdbcDriver
Liens
- unixODBC without the GUI: or, everything you wanted to know about odbcinst but were afraid to ask
- HSQLDB:Tips_and_Tricks: accès à une base HSQLDB externe
- Mysql, JDBC and relationships in Openoffice.org 2.0.x: activer la gestion des relations pour MySQL