Installation BDP FIREBIRD - John COLIBRI. |
- résumé : Détail de l'installation du Borland Data Provider pour la base de données Open Source Firebird
- mots clé : Firebird - .Net Framework - Delphi - BDP - Installation
- logiciel utilisé : Windows XP Home - .Net SDK 1.1.432 - Firebird 1.5.2 - Firebird .Net Provider 1.7.1 - Delphi 2005
- matériel utilisé : Pentium 2.800Mhz, 512 M de mémoire, 250 Giga disque dur
- champ d'application : développeur base de données Windows .Net
- niveau : développeur Delphi ou autre langage .Net
- plan :
1 - Introduction Un de nos stagiaires souhaitant travailler en Firebird plutôt qu'en Interbase, Sql Server ou Oracle, nous avons installé Firebird sur deux postes. Nous avons déjà présenté Cet article indique les étapes pour installer le Borland Data Provider de Firebird.
D'autres articles présenteront comment développer des applications utilisant Firebird, essentiellement avec le .Net Framework
2 - Téléchargement du DataProvider
Le fichier utilisé provient de: http://prdownloads.sourceforge.net/firebird/FirebirdBDP1.0-Alpha4.exe Si ce lien n'est plus valable, utilisez Google avec les mot +"firebird"+"firebirdbdp"
Ou encore allez sur les sites IbPhoenix ou FirebirdSql, indiqué dans les références ci dessous. Le téléchargement prend quelques minutes, et place un fichier de 492 Ko sur votre disque
3 - Installation du Bpd 3.1 - Prérequis Nous supposons que vous avez déjà installé Si vous souhaitez travailler en Delphi, Delphi (Delphi-8, Delphi-2005,
Delphi-2006) devront aussi avoir été installés
3.2 - Installation Voici comment installer les fichiers: |
cliquez sur FirebirdBDP1.0-Alpha4.exe | | l'installateur demande quel langage d'installation utiliser
| | sélectionnez votre langage et cliquez "Next" |
| l'installateur affiche un message de bienvenue |
| cliquez "Next" | | l'installateur affiche la licence
| | cochez "Yes" et cliquez "Next" |
| l'installateur présente un Readme |
| cliquez "Next" | | l'installateur demande dans quel répertoires places les fichiers :
| | changez éventuellement le chemin et cliquez "Next" |
| l'installateur demande quel groupe (menu) utiliser : |
| cliquez "Next" | | l'installateur indique qu'il est prêt
| | cliquez "Next"
puis | |
cliquez "Finish" |
3.3 - Vérifier les fichiers Nous pouvons vérifier que les fichiers sont bien installés: - ouvrez un Explorateur Windows et affichez les fichiers :
- ouvrez de même le menu "Démarrer | Programs | Firebird BPD"
Pourtant, si vous lancez Delphi, rien n'apparaîtra ni dans la palette, ni dans le DataManager, ni dans les assemblies connues. RTFM: le Readme indique qu'il faut installer manuellement l'assembly dans le cache en utilisant GACUTIL.EXE
puis modifier les fichiers de paramètres de Delphi.
3.4 - Ajout du BDP au cache .Net Pour ajouter FirebirdSql.Data.BDP.DLL au cache .Net |
lancez Notepad et tapez le texte suivant Sauvegardez le dans le répertoire de Fb BDP sous build_fb_bdp.bat |
| cliquez sur ce .BAT | | gacutil installe la dll
|
3.5 - Les fichiers de paramétrage de Delphi Pour que le Firebird BDP soit pris en compte par l'IDE Delphi, il faut tout
d'abord ajouter des paramètres à deux fichiers de configuration - bdpdatasources.xml
- BdpConnections.xml
Pour cela |
cliquez sur "readme.txt" situé dans c:\"Program Files\FirebirdBDP1.0" | | NotePad charge le fichier
| | ouvrez un Explorateur Windows, et allez dans "Program Files | Borland | BDS
| 3.0 | BIN" | |
créez un sous-répertoire (par exemple "save") et copiez-y ces ces fichiers, pour pouvoir aisément revenir à la situation initiale. | |
dans l'Explorateur Windows, effectuez un clic droit souris sur bdpdatasources.xml, sélectionnez "Open With" et sélectionnez NotePad ATTENTION: ne cliquez pas sur le fichier (clic gauche), car ceci lancerait
Internet Explorer, qui affiche bien le fichier mais ne permet pas de le modifier | | ouverture du .XML
| | copiez les lignes concernant le provider du readme et coller les dans le fichier .XML
<provider name="Firebird" connectionStringType="FirebirdSql.Data.Bdp.
FbConnectionString, FirebirdSql.Data.Bdp, Version=1.0.0.0, Culture=neutral, PublicKeyToken=c7d0a028dd9e545b"> <objectTypes>
<objectType>Tables</objectType> <objectType>Procedures</objectType>
<objectType>Views</objectType> </objectTypes> </provider> | |
| le fichier .XML sera similaire à: Sauvegardez ce fichier |
| ouvrez de même BdpConnections.xml et ajoutez la chaîne de connection:
<BdpConnectionString xsi:type="FbConnectionString"> <Name>FbConn1</Name> <Database>localhost/3050:employee.fdb</Database>
<UserName>sysdba</UserName> <Password>masterkey</Password> <Assembly>FirebirdSql.Data.Bdp,Version=1.0.0.0,
Culture=neutral,PublicKeyToken=c7d0a028dd9e545b</Assembly> </BdpConnectionString> | | |
le fichier .XML sera similaire à : | | sauvegardez le fichier |
3.6 - Test du BDP | lancez Delphi 2005 | |
le Bdp Firebird est bien installé: |
Nous allons tester la connection avec une base. Pour cela, il faut indiquer où
se trouve notre fichier .FDB. Nous pouvons soit ajouter une nouvelle connection au DataBase Manager, soit modifier la connection par défaut. Nous allons modifier la connection par défaut:
| dans le Database Manager, effectuez un click droit souris sur FbConnection1 |
| le Database Manager ouvre l'éditeur de connection : |
| remplacez la base suggérée par votre base de données. Nous avons utilisé c:\programs\employee.fdb |
| cliquez Ok (pour sauvegarder) | | ouvrez à nouveau, et clickez "Test" |
| l'éditeur affiche: |
4 - Références Firebird Pour récupérer les fichiers d'installation, voici les URLS: - Dot Net Firebird : la BDP Firebird
- Firebird Sql le site des développeurs de Firebird
- SourceForge le site de
téléchargement de logiciels Open Source, dont le BDP Firebird .Net
- IbPhoenix : la page de base Interbase / Firebird. Paul BEACH, Helen BORIE, Ann HARRISSON etc
Vous pouvez aussi consulter les articles suivants sur Firebird sur ce site: - firebird_installation: installation du Serveur et du Client Firebird.
Le détail pas à pas avec les vérifications à chaque étape
- firebird_dot_net_installation: installation du DataProvider Firebird
permettant d'utiliser le moteur avec .Net, et installation du DataProvider dans l'IDE Delphi
- firebird_ado_net_tutorial: ADO .Net Tutorial, utilsant Firebird. Une
introduction complète au développement ADO .Net, utilisant SqlConnection, SqlCommand, SqlDataAdapter pour se connecter à un Serveur, exécuter
directement du SQL, travailler avec des tables en mémoire, utiliser des DataGrids pour afficher et modifier les données. Très nombreux schémas et code source complets
ainsi que plusieurs articles sur Interbase
Rappelons aussi que nous organisons tous les mois des formations, et en particulier pour ceux intéressés par les bases de données et .Net:
Nous avons déjà organisé pour certains clients des formations ADO.Net uniquement (3 jours), et envisageons de la placer au catalogue. Ceux intéressés peuvent nous contacter à jcolibri@jcolibri.com.
Comme d'habitude: - nous vous remercions de nous signaler toute erreur, inexactitude ou problème de téléchargement en envoyant un e-mail à jcolibri@jcolibri.com. Les corrections
qui en résulteront pourront aider les prochains lecteurs
- tous vos commentaires, remarques, questions, critiques, suggestion d'article, ou mentions d'autres sources sur le même sujet seront de même
les bienvenus à jcolibri@jcolibri.com.
- plus simplement, vous pouvez taper (anonymement ou en fournissant votre e-mail pour une réponse) vos commentaires ci-dessus et nous les envoyer en
cliquant "envoyer" :
- et si vous avez apprécié cet article, faites connaître notre site,
ajoutez un lien dans vos listes de liens ou citez-nous dans vos blogs ou réponses sur les messageries. C'est très simple: plus nous aurons de visiteurs et de références Google, plus nous écrirons d'articles.
5 - L'auteur John COLIBRI est passionné par le développement Delphi et les applications de Bases de Données. Il a écrit de nombreux livres et articles, et partage son temps entre le développement de projets (nouveaux projets, maintenance, audit, migration BDE, migration Xe_n, refactoring) pour ses clients, le
conseil (composants, architecture, test) et la
formation. Son site contient des articles
avec code source, ainsi que le programme et le calendrier des stages de formation Delphi, base de données, programmation objet, Services Web, Tcp/Ip et
UML qu'il anime personellement tous les mois, à Paris, en province ou sur site client. |