Difference between revisions of "FR/Documentation/Base/MySQL Connector"

Latest revision as of 10:20, 28 May 2010

Introduction

MySQL Connector pour OpenOffice.org est un pilote MySQL pour OpenOffice.org. Il est utilisé pour connecter un serveur MySQL 5.1 ou plus récent à OpenOffice.org 3.1 ou plus récent.

Avant que MySQL Connector pour OpenOffice.org ne devienne disponible vous deviez utiliser MySQL Connector/J (JDBC) ou MySQL Connector for ODBC pour vous connecter à un serveur MySQL.

En fait le pilote est aussi considéré comme un pilote natif dans le contexte de OpenOffice.org. Le terme pilote natif se télescope avec la définition MySQL d'un pilote natif : MySQL Connector pour OpenOffice.org n'implémente pas le protocole Client/Serveur MySQL. Techniquement parlant MySQL Connector pour OpenOffice.org est implémenté comme un mandataire (proxy) en haut de MySQL Connector/C++.

Le pilote est distribué comme une extension OpenOffice.org.

Avantages

L'utilisation de MySQL Connector pour OpenOffice.org procure les avantages suivants :

• Installation facile par le gestionnaire des extensions d'OpenOffice.org.
• Intégration transparente dans OpenOffice.org.
• Connexion au serveurs MySQL par l'utilisation de tubes nommés (Windows) ou Sockets (Unix)
• Plus besoin de passer par une routine de connexion additionnelle (ODBC/JDBC)
• Plus besoin de configurer ou d'enregistrer un connecteur additionnel (ODBC)
• Plus besoin d'installer ou de configurer un gestionnaire de pilote (ODBC)
• Plus besoin de JRE (???) Java Runtime Environment (JDBC)

État

MySQL Connector pour OpenOffice.org est distribué en version 1.0, qualité production.

Installation

Installation ou mise à jour vers OpenOffice.org 3.1

OpenOffice.org 3.1 est disponible sur son site de téléchargement. Le pilote ne fonctionne pas avec des versions antérieures. (Anticipé : Il fonctionnera également au moins jusqu'à la version de développement DEV300.m57)

Veuillez utiliser la version originale d'OpenOffice.org, car toutes les extensions contenant du code binaire sont potentiellement incompatibles avec d'autres distributions d'OpenOffice.org (comme celle de votre distribution Linux favorite), et il n'est pas nécessairement attendu que ce connecteur fonctionne avec elle. Si vous utilisez une autre distribution obtenue ailleurs, par exemple certaines distributions Linux, alors demandez plutôt à cette source de fournir également MySQL Connector pour OpenOffice.org.

Télécharger MySQL Connector pour OpenOffice.org

L'extension est disponible au dépôt des extensions de OpenOffice.org. Elle est fournie pour les 6 plateformes habituelles (Windows, Linux Intel 32 Bit, Linux Intel 64 Bit, Solaris Sparc, Solaris Intel 32 Bit, Mac OS X Intel).

Téléchargez le fichier à un emplacement de votre choix, par exemple Mes Documents ou ~/Documents.

NB : Utilisateurs de la version Beta

Si vous aviez installé la version Beta précédente veuillez d'abord la désinstaller manuellement dans le gestionnaire d'extensions. La version finale a un nouveau nom de produit et il n'est donc pas possible de la mettre à jour via le mécanisme du gestionnaire d'extensions. Supprimez également la connexion base de données en cache qui fut précédemment créée comme elle ne peut pas être réutilisée (par exemple Windows : "C:\Documents and Settings\<utilisateur>\Application Data\OpenOffice.org\3\user\uno_packages\cache\registry\*" ou Unix: "/home/<utilisateur>/.openoffice.org/3/user/uno_packages/cache/registry/*").

Installer l'extension

Ajoutez l'extension .oxt par le gestionnaire d'extensions d'OpenOffice.org. Dans OpenOffice.org, sélectionnez Outils, Gestionnaire des extensions... et « Ajouter... » le fichier .oxt comme nouvelle extension. Ceci fait, MySQL Connector for OpenOffice.org devrait apparaître dans le gestionnaire d'extensions.

Redémarrez OpenOffice.org pour terminer l'installation.

Notions de base : Connexion à MySQL

MySQL Connector pour OpenOffice.org vous permet d'accéder au Serveur MySQL et à ses schémas depuis la suite OpenOffice.org.

L'exemple suivant montre la création d'une nouvelle base de données OpenOffice.org Base utilisant un serveur MySQL local pour le stockage des données et le nouveau connecteur pour la connexion.

Sélectionner la base de données

Créez une nouvelle base de données (Fichier, Nouveau, Base de données). Ceci vous permet d'en créer une nouvelle, d'ouvrir un fichier existant, ou de « Se connecter à une base de données existante ». Sélectionnez la dernière option.

Dans la liste déroulante, sélectionnez MySQL. Cliquez sur le bouton Suivant >>.

Sélectionner le type de pilote

Vous pouvez utiliser trois différents pilotes MySQL pour une connexion MySQL depuis OpenOffice.org. Vous pouvez choisir une connexion générique ODBC ou JDBC ou le pilote natif (connexion directe). Sélectionnez Connecter directement. Cliquer sur Suivant >>.

Définir la connexion à la base de données

Définissez la connexion à la base de données. Entrez le schéma (la base de données) auquel vous voulez vous connecter dans le champ Nom de la base de données. Entrez l'URL du serveur (son nom, ou entrez simplement localhost si vous connectez le serveur sur votre propre PC), le Port et le Tube nommé (Socket) (ou laissez le Tube nommé vide) de votre serveur MySQL. Cliquez sur Suivant >>.

Paramétrer l'authentification de l'utilisateur

Fournissez l'identité de l'utilisateur pour la connexion à votre serveur MySQL. Cliquez sur Suivant >>.

Sauver et confirmer

Terminez l'assistant. Tous les choix par défaut sont sains. Cliquez sur Terminer >>.

Notions de base : Exemples d'utilisation

Si vous êtes nouveau dans l'univers de MySQL vous voudrez sans doute consulter leur page de documentation, à partir de laquelle vous trouverez un manuel de référence pour la version 5.0 en français, qui devrait facilement vous permettre de créer votre première base de données.

Liste des Tables

Dans l'espace de travail de la fenêtre principale de Base, sélectionnez les tables. Si c'est la première fois que vous accédez à la base de données il vous sera demandé de vous authentifier (nom d'utilisateur et mot de passe) ; vous pouvez conserver ces données pour la session courante.

Selon vos réglages de connexion vous verrez maintenant toutes les bases de données avec toutes leurs tables, ou seulement la base de données que vous avez spécifiée dans les réglages de connexion.

Problèmes connus

Il y a actuellement 1 problème connu dans MySQL Connector for OpenOffice.org. Nous avons pourtant décidé de diffuser la version 1.0, car nous pensons qu'elle est la meilleure pour l'ensemble des utilisateurs qui ne rencontrent pas ce problème particulier, de bénéficier de cette fameuse extension.

Contact

Si vous découvrez un bug, ou voulez juste donner quelque nature de retour sur le connecteur, merci d'envoyer un message (en anglais) à users@dba.openoffice.org. C'est une liste de diffusion d'un petit volume de données, avec moins de 10 mails par jour. Si vous préférez la lire autrement qu'en y souscrivant, voyez ici.