Introduction à InterBase Express
Remonter à Développement d'applications de bases de données
InterBase Express (IBX) est un ensemble de composants d'accès aux données qui permet d'accéder à des données de bases de données InterBase. Les composants Administration InterBase, qui requièrent InterBase, sont décrits après les composants d'accès aux données InterBase.
Sommaire
- 1 Composants IBX
- 1.1 IBDatabase
- 1.2 IBTransaction
- 1.3 Composants ensemble de données IBX
- 1.4 IBTable
- 1.5 IBQuery
- 1.6 IBDataSet
- 1.7 IBStoredProc
- 1.8 IBSQL
- 1.9 IBSQLMonitor
- 1.10 IBDatabaseInfo
- 1.11 IBEvents
- 1.12 Composants Administration InterBase
- 1.13 IBConfigService
- 1.14 IBBackupService
- 1.15 IBRestoreService
- 1.16 IBValidationService
- 1.17 IBStatisticalService
- 1.18 IBLogService
- 1.19 IBSecurityService
- 1.20 IBServerProperties
- 2 Voir aussi
Composants IBX
Les composants suivants sont situés sur l'onglet InterBase de la palette des composants.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Script InterBase |
|
|
Analyseur SQL InterBase |
|
|
|
|
|
Bien que leurs noms soient similaires à ceux des composants BDE, les composants IBX sont quelque peu différents. Les sections ci-dessous présentent ces différences pour les composants ayant un équivalent BDE.
Remarque : Il n'existe pas de migration simple d'applications BDE vers des applications IBX. Vous devrez généralement remplacer les composants BDE par les composants IBX comparables, puis recompiler vos applications. Toutefois, la vitesse gagnée et les puissantes fonctionnalités InterBase auxquelles vous pouvez alors accéder justifient pleinement la migration.
IBDatabase
Utilisez un composant IBX.IBDatabase.TIBDatabase pour établir des connexions à des bases de données susceptibles d'impliquer une ou plusieurs transactions simultanées. A la différence de BDE, IBX possède un composant transaction distinct qui permet de séparer les transactions des connexions de base de données.
Pour définir une connexion de base de données
- Déposez un composant IBDatabase sur une fiche ou un module de données.
- Initialisez la propriété DatabaseName. Pour une connexion locale, il s'agit du lecteur, du chemin et du nom du fichier de la base de données. Initialisez la propriété Connected à True.
- Entrez un nom d'utilisateur et un mot de passe corrects puis cliquez sur OK pour établir la connexion à la base de données.
Astuce : Vous pouvez stocker le nom de l'utilisateur et son mot de passe dans la propriété Params du composant IBDatabase en initialisant la propriété LoginPrompt à False après l'ouverture de la session. Par exemple, après avoir ouvert une session en tant qu'administrateur système et avoir initialisé la propriété LoginPrompt à False, vous pourrez voir les informations suivantes en éditant la propriété Params :
user_name=sysdba
password=masterkey
IBTransaction
A la différence de Borland Database Engine, IBX contrôle les transactions avec un composant séparé, IBX.IBDatabase.TIBTransaction. Cette fonctionnalité puissante vous permet de séparer les transactions des connexions de base de données pour pouvoir bénéficier du mécanisme de validation à deux phases d'InterBase (les transactions s'étendant sur plusieurs connexions) et de plusieurs transactions simultanées utilisant la même connexion.
Utilisez un composant IBTransaction pour gérer les contextes de transactions, qui peuvent mettre en jeu une ou plusieurs connexions de base de données. Dans la plupart des cas, un modèle simple avec une base de données et une transaction fera l'affaire.
Pour définir une transaction
- Définissez une connexion IBDatabase comme décrit ci-dessus.
- Déposez un composant IBTransaction sur la fiche ou le module de données.
- Affectez à la propriété DefaultDatabase le nom de votre composant IBDatabase.
- Initialisez la propriété Active à True pour démarrer la transaction.
Composants ensemble de données IBX
Il existe plusieurs composants ensembles de données parmi lesquels vous pouvez faire votre choix avec IBX ; chacun possède ses caractéristiques propres et est adapté à des tâches particulières :
IBTable
Utilisez un composant IBX.IBTable.TIBTable pour définir un ensemble de données dynamique sur une table ou une vue sans avoir à entrer d'instructions SQL.
Pour configurer les composants IBTabl
- Ajoutez un composant IBTable à votre fiche ou votre module de données.
- Spécifiez les composants base de données et transaction associés.
- Spécifiez le nom de la relation à partir de la liste déroulante TableName.
- Initialisez la propriété Active à True.
IBQuery
Utilisez un composant IBX.IBQuery.TIBQuery pour exécuter n'importe quelle instruction DSQL InterBase, restreindre votre ensemble de résultats à certaines colonnes et certaines lignes, utiliser des fonctions d'agrégation et effectuer des jointures entre plusieurs tables.
Les composants IBQuery fournissent un ensemble de données en lecture seule et s'adaptent bien à l'environnement client-serveur d'InterBase. Pour définir un composant IBQuery :
Pour définir un composant IBQuery
- Définissez une connexion IBDatabase comme décrit ci-dessus.
- Définissez une connexion IBTransaction comme décrit ci-dessus.
- Ajoutez un composant IBQuery à votre fiche ou votre module de données.
- Spécifiez les composants base de données et transaction associés.
- Entrez dans l'éditeur de listes de chaînes une instruction SQL valide pour la propriété SQL du composant IBQuery.
- Initialisez la propriété Active à True.
IBDataSet
Utilisez un composant IBX.IBCustomDataSet.TIBDataSet pour exécuter n'importe quelle instruction DSQL InterBase, restreindre votre ensemble de résultats à certaines colonnes et certaines lignes, utiliser des fonctions d'agrégation et effectuer des jointures entre plusieurs tables. Les composants IBDataSet sont similaires aux composants IBQuery, mis à part qu'ils prennent en charge les ensembles de données dynamiques sans nécessiter un composant IBUpdateSQL.
L'exemple suivant fournit un ensemble de données dynamique pour la table COUNTRY dans employee.gdb :
- Définissez une connexion IBDatabase comme décrit ci-dessus.
- Spécifiez les composants base de données et transaction associés.
- Ajoutez un composant IBDataset à votre fiche ou votre module de données.
- Entrez des instructions SQL pour les propriétés suivantes :
|
SelectSQL |
SELECT Country, Currency FROM Country |
|
RefreshSQL |
SELECT Country, Currency FROM Country WHERE Country = :Country |
|
ModifySQL |
UPDATE Country SET Country = :Country, Currency = :Currency WHERE Country = :Old_Country |
|
DeleteSQL |
DELETE FROM Country WHERE Country = :Old_Country |
|
InsertSQL |
INSERT INTO Country (Country, Currency) VALUES (:Country, :Currency) |
- 5. Initialisez la propriété Active à True.
Remarque : Les paramètres et les champs transmis aux fonctions sont sensibles à la casse dans le dialecte 3. Par exemple,
FieldByName(EmpNo)
ne renvoie rien dans le dialecte 3 si le champ est spécifié sous la forme 'EMPNO'.
IBStoredProc
Utilisez IBX.IBStoredProc.TIBStoredProc pour les procédures exécutables InterBase : les procédures qui renvoient au plus une ligne d'informations. Pour les procédures stockées renvoyant plus d'une ligne de données ou les procédures "Select", utilisez des composants IBQuery ou IBDataSet.
IBSQL
Utilisez un composant IBX.IBSQL.TIBSQL pour les opérations qui doivent être rapides et légères. Des opérations telles que la définition de données et la copie de données d'une base de données vers une autre sont bien adaptées aux composants IBSQL.
Dans l'exemple suivant, un composant IBSQL est utilisé pour renvoyer la valeur suivante à partir d'un générateur :
- Définissez une connexion IBDatabase comme décrit ci-dessus.
- Positionnez un composant IBSQL sur la fiche ou le module de données et affectez le nom de la base de données à sa propriété Database.
- Ajoutez une instruction SQL dans l'éditeur de listes de chaînes pour la propriété SQL, par exemple :
SELECT GEN_ID(MyGenerator, 1) FROM RDB$DATABASE
IBUpdateSQL
Utilisez un composant IBX.IBUpdateSQL.TIBUpdateSQL pour mettre à jour des ensembles de données en lecture seule. Vous pouvez mettre à jour une sortie IBQuery avec un composant IBUpdateSQL :
- Définissez un composant IBQuery comme décrit ci-dessus.
- Ajoutez un composant IBUpdateSQL à votre fiche ou votre module de données.
- Entrez des instructions SQL pour les propriétés suivantes : DeleteSQL, InsertSQL, ModifySQL et RefreshSQL.
- Affectez le nom du composant IBUpdateSQLà la propriété UpdateObject du composant IBQuery.
- Initialisez la propriété Active du composant IBQuery à True.
IBSQLMonitor
Utilisez un composant IBX.IBSQLMonitor.TIBSQLMonitor pour développer des outils de diagnostic permettant de surveiller les communications entre votre application et le serveur InterBase. Quand les propriétés TraceFlags d'un composant IBDatabase sont activées, les composants TIBSQLMonitor actifs peuvent surveiller l'activité de la connexion et envoyer le résultat vers un fichier ou un contrôle.
Un bon exemple consisterait à créer une application séparée avec un composant TIBSQLMonitor et un contrôle Memo. Lancez cette deuxième application, puis dans l'application principale, activez les propriétés TraceFlags du composant IBDatabase. Travaillez avec l'application principale et observez le contrôle Memo de la deuxième application se remplir de données.
IBDatabaseInfo
Utilisez un composant IBX.IBDatabaseInfo.TIBDatabaseInfo pour lire des informations sur une base de données particulière, comme son intervalle de nettoyage, sa version ODS et les noms des utilisateurs actuellement connectés à cette base de données.
La procédure suivante est un exemple de façon de définition d'un composant IBDatabaseInfo affichant les utilisateurs actuellement connectés à la base de données, procédez comme suit :
Pour définir un composant IBDatabaseInfo
- Définissez une connexion IBDatabase comme décrit ci-dessus.
- Placez un composant IBDatabaseInfo sur la fiche ou le module de données et affectez à sa propriété Database le nom de la base de données.
- Placez un composant Memo sur la fiche.
- Placez un composant Timer sur la fiche et définissez son intervalle.
- Double-cliquez sur le champ de l'événement OnTimer du composant Timer et entrez un code de la forme :
Memo1.Text := IBDatabaseInfo.UserNames.Text; // Exemple Delphi
Memo1->Text = IBDatabaseInfo->UserNames->Text; // Exemple C++
IBEvents
Utilisez un composant IBEvents pour demander la notification et traiter de manière asynchrone les événements transmis par un serveur InterBase.
Pour définir un composant IBEvents
- Définissez une connexion IBDatabase comme décrit ci-dessus.
- Positionnez un composant IBEvents sur la fiche ou le module de données et affectez le nom de la base de données à sa propriété Database.
- Entrez des événements dans l'éditeur de listes de chaînes de la propriété Events, par exemple :
IBEvents.Events.Add('EVENT_NAME'); // Exemple Delphi
IBEvents->Events->Add("EVENT_NAME"); // Exemple C++
- 4. Initialisez la propriété Registered à True.
Composants Administration InterBase
Si vous avez installé InterBase, vous pouvez utiliser les composants Administration InterBase, qui vous permettent d'accéder aux puissants appels à l'API des services InterBase.
Les composants suivants sont situés sur l'onglet d'administration d'InterBase de l'EDI :
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Remarque : Pour utiliser ces fonctionnalités, vous devez installer InterBase.
IBConfigService
Utilisez un objet IBX.IBServices.TIBConfigService pour configurer les paramètres d'une base de données, y compris les tampons de pages, le mode asynchrone, l'espace de réserve et l'intervalle de balayage.
IBBackupService
Utilisez un objet IBX.IBServices.TIBBackupService pour effectuer une copie de sauvegarde de votre base de données. Cet objet vous permet de définir des paramètres tels que le facteur de blocage, le nom du fichier de sauvegarde et les options de sauvegarde de la base de données.
IBRestoreService
Utilisez un objet IBX.IBServices.TIBRestoreService pour restaurer votre base de données. Cet objet vous permet de définir des options telles que les tampons de pages, la taille des pages et les options de restauration de la base de données.
IBValidationService
Utilisez un objet IBX.IBServices.TIBValidationService pour valider votre base de données et réconcilier vos transactions de base de données. Cet objet vous permet de définir l'action de transaction par défaut, de renvoyer des informations sur les transactions limbo et de définir d'autres options de validation de la base de données.
IBStatisticalService
Utilisez un objet IBX.IBServices.TIBStatisticalService pour afficher les statistiques sur la base de données, par exemple les pages de données, le journal de la base de données, les pages d'en-tête, les pages d'index et les relations système.
IBLogService
Utilisez un objet IBX.IBServices.TIBLogService pour créer un fichier journal.
IBSecurityService
Utilisez un objet IBX.IBServices.TIBSecurityService pour gérer l'accès des utilisateurs au serveur InterBase. Cet objet vous permet de créer, de supprimer et de modifier des comptes utilisateur, d'afficher tous les utilisateurs et de définir des groupes de travail en utilisant des rôles SQL.
IBServerProperties
Utilisez un composant IBX.IBServices.TIBServerProperties pour renvoyer des informations sur le serveur, y compris les paramètres de configuration, les informations relatives à la version et à la licence.