SQLdb Package/fr: what changed
Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | 1 | The SQLdb package contains FPC units to access a number of SQL databases. It is "packaged" as sqldblaz.lpk in Lazarus, and the components can be found on the [[SQLdb tab]]. | |
| 2 | 2 | ||
| 3 | - | ||
| 4 | - | ||
| 5 | - | ||
| 6 | - | ||
| 3 | + |  | |
| 7 | 4 | ||
| 8 | 5 | # Documentation | |
| 9 | 6 | ||
| 10 | 7 | Voir la [documentation SQLDB](http://www.freepascal.org/docs-html/fcl/sqldb/index.html) | |
| 11 | 8 | ||
| 12 | 9 | # Composants | |
| 13 | 10 | ||
| 14 | 11 | Le paquet SQLdb fournit les composants suivants : | |
| 15 | 12 | ||
| 16 | 13 | ## TXXXConnection | |
| 17 | 14 | ||
| 18 | 15 | Documentation : voir la [documentation TSQLConnection](http://www.freepascal.org/docs-html/fcl/sqldb/tsqlconnection.html) | |
| 19 | 16 | ||
| 20 | 17 | Il y a divers composants de connexion appelés TXXXConnection,où XXX est la base de données à laquelle vous êtes connectés. Chacun de ces composants prend les requêtes des composants SQLQuery et SQLTransaction et les traduit dans des requêtes spécialement taillées pour la base de données que vous utilisez. Ces cobjets de connexion descendent de la classe de base TSQLConnection ; vous pouvez utiliser TSQLConnection pour créer des programmes de base de données qui peuvent se connecter à des multiples SGBDR (voir [[SQLdb Tutorial3/fr|Tutoriel 3 de SQLdb]]. | |
| 21 | 18 | ||
| 22 | 19 | Les composants actuels sont : | |
| 23 | 20 | ||
| 24 | 21 | - TIBConnection ([[Firebird/fr|Borland Interbase / Firebird]]) | |
| 25 | 22 | - TMSSQLConnection ([[mssqlconn/fr|Microsoft SQL Server]], disponible depuis FPC version 2.6.1/Lazarus 1.0.8) | |
| 26 | 23 | - TMySQL40Connection ([[MySQLDatabases/fr|MySQL]], demande la bibliothèque client MySQL 4.0) | |
| 27 | 24 | - TMySQL41Connection ([[MySQLDatabases/fr|MySQL]], demande la bibliothèque client MySQL 4.1) | |
| 28 | 25 | - TMySQL50Connection ([[MySQLDatabases/fr|MySQL]], demande la bibliothèque client MySQL 5.0) | |
| 29 | 26 | - TMySQL51Connection ([[MySQLDatabases/fr|MySQL]], demande la bibliothèque client MySQL 5.1, disponible depuis FPC version 2.5.1) | |
| 30 | 27 | - TMySQL55Connection ([[MySQLDatabases/fr|MySQL]], demande la bibliothèque client MySQL 5.5, disponible depuis FPC version 2.6.1/Lazarus 1.0.8) | |
| 31 | 28 | - TODBCConnection (Une connexion ODBC vers une base de données pour laquelle le PC a les pilotes ; voir [[ODBCConn/fr|ODBCConn]]) | |
| 32 | 29 | - TOracleConnection ([[Lazarus Database Overview/fr|Oracle]]) | |
| 33 | 30 | - TPQConnection ([[postgres/fr|PostgreSQL]]) | |
| 34 | 31 | - TSybaseConnection ([[mssqlconn/fr|Sybase ASE]], disponible depuis FPC version 2.6.1/Lazarus 1.0.8) | |
| 35 | 32 | - TSQLite3Connection ([[SQLite/fr|SQLite]], disponible depuis FPC version 2.2.2) | |
| 36 | 33 | ||
| 37 | 34 | ## TSQLTransaction | |
| 38 | 35 | ||
| 39 | 36 | Documentation : voir la [documentation TSQLTransaction](http://www.freepascal.org/docs-html/fcl/sqldb/tsqltransaction.html). | |
| 40 | 37 | ||
| 41 | 38 | Ceci encapsule la transaction sur le serveur de base de données. Un objet TXXXConnection demande toujours au moins un TSQLTransaction associé avec, ainsi la transaction de ses requêtes est gérée. Les requêtes/actions sur la base de données dont besoin d''être encapsulées dans : | |
| 42 | 39 | ||
| 43 | 40 | - un bloc .StartTransaction/.Commit (ou .Rollback) | |
| 44 | 41 | - ou un simple .StartTransaction au début, suivi de .CommitRetaining ou .RollBackretaining. CommitRetaining et RollbackRetaining conservent la transaction ouverte, ainsi il n'est pas nécessaire de démarrer une autre transaction. | |
| 45 | 42 | ||
| 46 | 43 | Définir .Active à True si elle est à False est équivalent à appeler .StartTransaction. | |
| 47 | 44 | ||
| 48 | 45 | Définir .Active à False si elle est à True est équivalent à *.Rollback*. | |
| 49 | 46 | ||
| 50 | 47 | ## TSQLQuery | |
| 51 | 48 | ||
| 52 | 49 | Documentation : voir [TSQLQuery](http://www.freepascal.org/docs-html/fcl/sqldb/tsqlquery.html). | |
| 53 | 50 | ||
| 54 | 51 | C'est un descendant de TDataset, et fournit les données comme une table depuis la requête SQL que vous avez soumis. Néanmoins, il peut aussi être utilisé pour executer des requêtes SQL (p.ex. des procédures stockées , INSERT INTO..) qui ne retournent aucune donnée. Voir [[Working With TSQLQuery/fr|travailler avec TSQLQuery]] pour plus de détails. | |
| 55 | 52 | ||
| 56 | 53 | # Utilisation du paquet SQLdb | |
| 57 | 54 | ||
| 58 | 55 | Pour utiliser le paquet SQLdb, vous avez besoin d'un composant TSQLQuery, d'un composant TSQLTransaction et un des composants de connexion. | |
| 59 | 56 | ||
| 60 | 57 | Voici un tutoriel rapide : | |
| 61 | 58 | ||
| 62 | 59 | - Assurez-vous que vous avez un pilote/client pour la base de données concernée. | |
| 63 | 60 | - Allez sur l'onglet SQLdb dans la palette de composants. | |
| 64 | 61 | - Ajoutez un composant TXXXConnection (selon la base de donnée utilisée) à votre fiche et remplissez les propriétés appropriées pour vous connecter à la base de données. Celles-ci varient selon la base de données courante. Assurez-vous de pouvoir mettre la propriété *.Connected* à True. | |
| 65 | 62 | - Ajoutez le composant TSQLTransaction. Revenez au composant Connection et et mettez sa propriété Transaction à la nouvelle transaction. Cela devrait aussi définir la propriété .Transaction du composant Database. Vous devriez pouvoir mettre .Active à True. | |
| 66 | 63 | - Ajoutez un composant SQLQuery et définissez sa propriété Database avec le composant Connection que vous venez d'ajouter. | |
| 67 | 64 | - Définissez la propriété "SQL". Pour un premier essai, faites juste un "select * from \<tablename\>". | |
| 68 | 65 | - Mettez Active à True. Si cela fonctionne, vous avez ouvert la requête et les données sont disponibles. | |
| 69 | 66 | ||
| 70 | 67 | A partir de là, l'ajout des contrôles est le même qu'avec tout autre base de données, soit juste pour rappeler : | |
| 71 | 68 | ||
| 72 | 69 | - Ajoutez un composant TDataSource (de l'onglet Data Access) et définissez sa propriété DataSet avec le composant TSQLQuery | |
| 73 | 70 | - Ajoutez quelques contrôles depuis l'onglet Data Controls. Pour vérifier rapidement, ajoutez un composant TDBGrid et définissez sa propriété DataSource avec la DataSource tout juste ajoutée. Vous devriez pouvoir voir les données provenant de la requête que vous avez entrée. | |
| 74 | 71 | ||
| 75 | 72 | Bien sûr, cela est juste un début, mais l'obtention de données dans un DBGrid est en général la première étape pour assurer que la connexion à la base de données fonctionne. Plus d'explications détaillées seront trouvées à [[Working With TSQLQuery/fr|Travailler avec des TSQLQuery]] et [[SQLdb Tutorial1/fr|Tutoriel SQLdb 1]]. | |
| 76 | 73 | ||
| 77 | 74 | # Voir aussi | |
| 78 | 75 | ||
| 79 | 76 | - [[SqlDBHowto/fr|Comment faire en SQL ?]] | |
| 80 | 77 | - [[SQLdb Programming Reference/fr|Référence de programmation SQLdb]] | |
| 81 | 78 | - [[Databases/fr|Bases de données]] | |
| 82 | 79 | - [Vue de l'interface des classes (en)](http://z505.com/cgi-bin/powtils/docs/1.6/idx.cgi?file=index-4&unit=sqldb) | |
| 83 | 80 | - [some additional documentation/notes Quelles docs/notes en plus (en)](http://z505.com/cgi-bin/powtils/docs/1.6/idx.cgi?file=fcldbnotes) | |
| 84 | - | ||
| 85 | - | ||
| 86 | 81 | ||
| 87 | 82 | --- | |
| 88 | 83 | *From the Free Pascal wiki, page "SQLdb Package/fr", as it stood on 2017-07-19 after a change by E-ric, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* |