Connexion à Firebird (FireDAC)
Remonter à Connectivité des bases de données (FireDAC)
Cette rubrique explique comment établir la connexion à une base de données Firebird.
Sommaire
Versions prises en charge
Le pilote natif FireDAC prend en charge le serveur Firebird et les éditions incorporées version 1.5 et ultérieure. Il ne supporte pas officiellement Jaffil.
Pour établir une connexion à InterBase, utilisez le pilote InterBase de FireDAC.
Logiciel client
Logiciel client Windows
FireDAC requiert l'installation des logiciels client x86 ou x64 suivants sur la station de travail :
- La bibliothèque FBCLIENT.DLL pour établir la connexion au serveur Firebird. Vous pouvez la récupérer dans le dossier Bin d'installation d'un serveur (télécharger (EN)).
- La bibliothèque FBEMBED.DLL pour le fonctionnement avec la base de données à l'aide du serveur incorporé Firebird (informations détaillées (EN)).
Vous pouvez placer les fichiers requis dans :
- un dossier inclus dans votre variable d'environnement PATH (par exemple, <Windows>\SYSTEM32).
- le dossier EXE de votre application.
Sinon, vous pouvez placer les fichiers nécessaires dans tout autre dossier et spécifier leur chemin d'accès dans FDDrivers.ini :
[FB]
VendorLib=<folder>\fbclient.dll
Si la bibliothèque client Firebird n'a pas été installée correctement, une exception est déclenchée lorsque vous tentez d'établir une connexion :
Logiciel client OS X
FireDAC requiert :
- la bibliothèque client libfbclient.dylib x86 pour établir la connexion au serveur Firebird. Vous pouvez la récupérer dans le dossier d'installation /Library/Frameworks/Firebird.framework/Libraries d'un serveur (télécharger (EN)).
Logiciel client Linux
FireDAC requiert la bibliothèque client the Firebird. Pour l'installer, procédez comme suit :
-
Sur Ubuntu Server 16.04 LTS, exécutez :
sudo apt-get install libfbclient2 sudo ln -s /usr/lib/x86_64-linux-gnu/libfbclient.so.2 /usr/lib/x86_64-linux-gnu/libfbclient.so
-
Sur Red Hat Enterprise Linux 7, exécutez :
sudo yum install firebird-libfbclient sudo ln -s /usr/lib64/libfbclient.so.2 /usr/lib64/libfbclient.so
Liaison du pilote
Pour lier le pilote :
- déposez les composants TFDPhysFBDriverLink et TFDConnection depuis la palette d'outils
- ou incluez l'unité FireDAC.Phys.FB dans la clause uses.
Paramètres de définition de la connexion
Pour établir la connexion au SGBD Firebird, la plupart des applications imposent que vous spécifiiez les paramètres de définition de connexion DriverID, Protocol, Server, Database, User_Name, Password et CharacterSet (voir Définition d'une connexion (FireDAC) pour plus d'informations).
DriverID=FB
Paramètre | Description | Valeur exemple |
---|---|---|
Database |
Nom de la base de données à attacher. La valeur peut être :
Pour une base de données incorporée, le chemin d'accès peut inclure des variables relatives au chemin. |
|
OSAuthent |
Contrôle le mode d'authentification :
Pour de plus amples informations, voir le fichier doc\README.trusted_authentication.txt. |
Yes |
User_Name | Nom d'utilisateur. | sysdba |
Password | Mot de passe utilisateur. | masterkey |
CharacterSet | Spécifie le jeu de caractères à utiliser. Nous vous recommandons fortement de définir explicitement le paramètre CharacterSet sur l'une des valeurs suivantes :
|
WIN1252 |
ExtendedMetadata |
Contrôle la description étendue des ensembles de résultats d'une requête :
|
False |
Port |
Port TCP/IP sur lequel le serveur Interbase écoute. Par défaut, il a une valeur égale à 3050. Quand il a une valeur différente, vous devez définir le paramètre "Port" sur la valeur requise. |
3051 |
Protocol |
Protocole utilisé pour établir la connexion au serveur de base de données. Il peut prendre l'une des valeurs suivantes :
Si le paramètre Protocol est spécifié, FireDAC construit des chemins d'accès complets aux bases de données, en utilisant le format Protocol approprié et les valeurs des paramètres Server et Database. |
TCPIP |
Server | Adresse du serveur auquel établir la connexion. La valeur du paramètre Server est utilisée uniquement si le paramètre Protocol est spécifié. Pour spécifier un numéro de port TCP/IP, utilisez la notation <host>/<port>. |
|
SQLDialect | Dialecte SQL à utiliser pour établir la connexion. La valeur par défaut est 3. | 1 |
RoleName | Nom du rôle par défaut. | Admin |
OpenMode |
Spécifie le mode d'ouverture d'une base de données. Les modes suivants sont pris en charge :
|
Open |
DropDatabase |
Contrôle la suppression d'une base de données existante :
|
Yes |
PageSize | Taille de page utilisée pour la nouvelle base de données créée si CreateDatabase = Yes. La valeur par défaut est 1024. | 4096 |
IBAdvanced | Liste de paramètres supplémentaires séparés par des ';'. Vous pouvez trouver la liste complète des paramètres pris en charge dans l'unité FireDAC.Phys.IBWrapper (voir le tableau constant DPBInfos). Vous pouvez trouver la description de chaque Code ainsi listé dans les manuels Interbase/Firebird. |
Cas d'utilisation
- Etablir une connexion à une base de données exécutée sur un serveur distant via le protocole TCP/IP :
DriverID=FB Database=C:\fb\ADDEMO_FB21.FDB Protocol=TCPIP Server=FBSrv User_Name=sysdba Password=masterkey CharacterSet=win1252 ExtendedMetadata=True
- Etablir une connexion à une base de données exécutée sur un serveur distant via le protocole TCP/IP :
DriverID=FB Database=FBSrv:C:\fb\ADDEMO_FB21.FDB User_Name=sysdba Password=masterkey CharacterSet=utf8
- Etablir une connexion à une base de données locale :
DriverID=FB Database=C:\fb\ADDEMO_FB21.FDB User_Name=sysdba Password=masterkey CharacterSet=win1251
- Etablir une connexion à une base de données incorporée Firebird :
Déposez le composant TFDPhysFBDriverLink sur la fiche et définissez sa propriété VendorLib sur <votre chemin<\fbembed.dll ou utilisez une définition de pilote virtuel.
DriverID=FB Database=C:\fb\ADDEMO_FB21.FDB User_Name=sysdba CharacterSet=utf8
Voir aussi
- Paramètres de connexion communs
- FAQ
- Comment configurer les pilotes FireDAC
- Comment gérer les définitions des connexions FireDAC
- Tutoriel : Utilisation de FireDAC depuis une application multi-périphérique sur les plates-formes de bureau
Exemples
- Exemple FireDAC Firebird