postgres/fr: what changed

Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		## Vue d'ensemble
2	2
3	3		Vous pouvez utiliser Free Pascal/Lazarus pour accéder à un serveur de base de données PostgreSQL. Si vous cherchez de l'information sur le paquet postgres dans FPC, veuillez consulter #Paquet PostgreSQL : les unités de bas-niveau plus bas.
4	4
5	5		Avantages de PostgreSQL:
6	6
7	7		- Il est disponible et largement utilisé
8	8		- Très stable et a un ensemble complet de fonctionnalités.
9	9		- Licence libérale (sans frais) par rapport à MySQL.
10	10
11	11		Inconvénient de PostgreSQL:
12	12
13	13		- Certains hébergeurs peuvent ne pas offrir PostgreSQL
14	14		- Pas de version incorporée (i.e. sans serveur distant/installé, comme Firebird le propose)
15	15
16	16		Win64: SVP, consulter l'avertissement [[Windows Programming Tips/fr\|ici]] sur l'inutilisation de certaines versions de FPC/Lazarus Win64.
17	17
18	18		## Accès direct à PostgreSQL
19	19
20	20		Vous pouvez vous connecter à PostgreSQL avec Lazarus en utilisant les composants PostgreSQL Data Access (PgDAC). C'est une bibliothèque de composants qui fournissent une connectivité native à PostgreSQL depuis Lazarus (et Free Pascal) sur Windows, Mac OS X, iOS, Android, Linux et FreeBSD pour les plates-formes 32-bit et 64-bit. PgDAC est conçue pour aider le programmeur à développer des applications PostgreSQL réellement légères, rapides et propres sans déploiement de bibliothèques supplémentaires.
21	21
22	22		Vous pouvez la télécharger librement depuis [Composants Lazarus](https://www.devart.com/pgdac/download.html).
23	23
24	24		## Zeos
25	25
26	26		Zeos prend en charge PostgreSQL ; veuillez lire [[ZeosDBO/fr\|ZeosDBO]].
27	27
28	28		## SQLDB
29	29
30	30		FPC / Lazarus prend en charge PostgreSQL avec un composant/classe de connexion PostgreSQL. Si vous utilisez FPC seulement ou voulez ajouter manuellement la prise en charge de PostgreSQL, ajoutez pqconnection à votre clause uses. Autrement, Lazarus fournit le composant :
31	31
32	32		![](/wiki-images/c/c5/Sqldbcomponents.png%E2%80%8E)
33	33
34	34		Note : la bibliothèque cliente C libpg contient quelques fuites de mémoires (au moins jusqu'à la version 9.3 de Postgres) quand une bibliothèque est chargée/déchargée de manière répétitive. SQLdb charge la bibliothèque à la première connexion, et la décharge à la dernière. Cela signifie que chaque fois que la dernière connexion est fermée, une petite fuite de mémoire est créée. Pour empêcher cela d'arriver (et accélérer l'application), vous pouvez charger le, vous pouvez charger la bibliothèque une fois au démarrage du processus avec l'appel à InitialisePostgres3.
35	35
36	36		La propriété charset est utilisée pour l'encodage du client.
37	37
38	38		Le composant TPQConnection ne prend pas en charge directement une propriété Port, on peut passer le port dans le composant via le paramètre Params :
39	39
40	40		``` pascal
41	41		PQConnection.Params.Add('port=' + VariableContainingPort);
42	42		```
43	43
44	44		D'autres paramètres de connexion particuliers peuvent être spécifiés en utilisant la propriéét Params :
45	45
46	46		``` pascal
47	47		PQConnection.Params.Add('application_name=''yourappname''')
48	48		```
49	49
50	50		### Exemple
51	51
52	52		Voir [[SQLdb Tutorial1/fr\|Tutoriel SQLdb 1]] pour un tutoriel sur la création d'une application de base de données avec IHM écrite avec PostgreSQL/SQLdb, aussi bien qu'avec SQLite/SQLDB, Firebird/SQLDB ou basiquement avec toute base de données prise en charge par SQLDB.
53	53
54	54		### Surveillance des événements
55	55
56	56		Si vous avez FPC 2.6.2+ et une version récente de Lazarus, vous pouvez utiliser le composant TPQTEventMonitor pour surveiller les événements venant de PostgreSQL.
57	57
58	58		C'est une enveloppe mince autour de FPC PQEventMonitor ; veuillez consulter le programme exemple FPC pqeventstest.pp pour les détails.
59	59
60	60		### Installation et erreurs
61	61
62	62		Comme pour toutes les unités SQLdb, vous avez besoin de vos bibliothèque cliente (tous les fichiers PostgreSQL .dll/.manifest)
63	63
64	64		- dans une dossier dans le chemin (de recherche des bibliothèques, tel que c:\windows\system32 pour Windows)
65	65		- ou (pour Windows) dans le dossier de votre programme (p.ex. lib\something\\ dans votre dossier de projet et le
66	66
67	67		#### Pilote Windows 64 bit
68	68
69	69		Pour développer une application 64 bit, vous devez utiliser une DLL 64 bit (remarque générale).
70	70
71	71		> Note: FPC 2.6.0 (et donc Lazarus 1.0.4 ou antérieur) ne supporte pas PostgreSQL sur Windows 64 bit (à moins de le corriger et le recompiler).
72	72
73	73		Un pilote Windows 64 bit est franchement difficile à trouver mais peut être téléchargé ici : [1](http://www.enterprisedb.com/products-services-training/pgdownload#windows). La bibliothèque du pilote peut être installée dans c:\windows\system32 ; les bibliothèques du pilote 32 bit peuvent être installées dans le maladroitement nommé c:\windows\syswow64.
74	74
75	75		#### Erreur: "Can not load PostgreSQL client library "libpq.dll""
76	76
77	77		Le programme ne peut pas trouver les fichiers du pilote PostgreSQL.
78	78
79	79		Voir ci-dessus pour les instructions d'installation des bibliothèques.
80	80
81	81		Un bon exemple qui démontre comment inclure les fichiers DLL du pilote en connectant Lazarus avec PostgreSQL sous Windows est [easyDB](http://paginas.fe.up.pt/~asousa/wiki/doku.php?id=proj:lazarus_projects#easy_db).
82	82
83	83		Sur Linux/Unix/OSX, assurez-vous que les bibliothèques PostgreSQL sont dans le chemin de recherche des bibliothèques, i.e. :
84	84
85	85		- Sur Linux, ajouter le chemin vers le fichier libpq.so vers la section libraries dans votre fichier /etc/fpc.cfg. P. ex. : -Fl/usr/local/pgsql/lib.
86	86		- Il peut être nécessaire de créer un lien symbolique depuis une version spécifique de la bibliothèque vers un nom général de bibliothèque :
87	87		``` bash
88	88		ln -s /usr/lib/pqsql.so.5 /usr/lib/pqsql.so
89	89		```
90	90
91	91		De manière alternative, installez le paquet -dev du client postgresql en utilisant le gestionnaire de paquets de votre distribution.
92	92
93	93		#### Problèmes de nettoyage des paramètres
94	94
95	95		> Note: Vérifiez ceci : est-ce que .paramtype est réellement nécessaire ?
96	96
97	97		Au moins dans FPC \<= 2.6.2 : si vous effacez (.clear) un paramètre (i.e. le mettre à NULL), PostgreSQL pourrait avoir des difficultés à reconnaître le type du paramètre.
98	98
99	99		Dans ce cas, spécifiez explicitement le type, p.ex. :
100	100
101	101		``` pascal
102	102		FWriteQuery.Params.ParamByName('LONGITUDE').ParamType:=ptInput; //required for postgresql
103	103		FWriteQuery.Params.ParamByName('LONGITUDE').Clear
104	104		```
105	105
106	106		## Comment faire
107	107
108	108		### Utiliser INSERT RETURNING
109	109
110	110		#### Obtenir le dernier ID inséré
111	111
112	112		Avec PostGres, il n'est pas nécessaire d'exécuter une seconde requête pour obtenir le dernier ID inséré.
113	113
114	114		Utilisez INSERT RETURNING et lisez la valeur :
115	115
116	116		``` pascal
117	117		var
118	118		ID: Integer
119	119		..
120	120		Query.SQL.Text:= 'INSERT INTO myschema.films(film_name)' +
121	121		'VALUES(:film_name) RETURNING film_id;';
122	122		Query.Open;
123	123		ID:= Query.FieldByName('film_id').AsInteger;
124	124		```
125	125
126	126		#### Obtenir des champs multiples et des expressions
127	127
128	128		RETURNING dans PostgreSQL est plus flexible que dans la plupart des SGBDR. Il marche avec les ordres INSERT, UPDATE et DELETE et peut être n'importe quelle liste de champs, constantes ou expression qui pourrait être renvoyée par un SELECT.
129	129
130	130		``` SQL
131	131		INSERT INTO films (film_name) VALUES ('val') RETURNING film_id; -- Returns id's for newly created rows.
132	132		INSERT INTO films (film_name) VALUES ('val') RETURNING film_id, kind; -- Returns id and kind fields in newly created rows.
133	133		INSERT INTO films (film_name) VALUES ('val') RETURNING *; -- Returns all fields in newly created rows.
134	134
135	135		UPDATE films SET kind = 'Dramatic' WHERE kind = 'Drama' RETURNING film_id; -- Returns id's of updated rows.
136	136		UPDATE films SET kind = 'Dramatic' WHERE kind = 'Drama' RETURNING film_id, film_name; -- Returns id and film names of updated rows.
137	137		UPDATE films SET kind = 'Dramatic' WHERE kind = 'Drama' RETURNING *; -- Returns all fields of updated rows.
138	138
139	139		DELETE FROM films RETURNING film_id; --Returns id's of deleted rows.
140	140		DELETE FROM films RETURNING film_id, film_name; --Returns id's and film names of deleted rows.
141	141		DELETE FROM films RETURNING *; -- Returns all fields of deleted rows.
142	142		```
143	143
144	144		RETURNING utilisant des champs, des constantes et des expressions :
145	145
146	146		``` SQL
147	147		INSERT INTO films (film_name) VALUES ('val') RETURNING id, 'a' AS a, id*2 AS doubled_id, CASE WHEN id > 100 THEN 'a' ELSE 'b' END AS foo;
148	148		```
149	149
150	150		## Paquet PostgreSQL : les unités de bas-niveau
151	151
152	152		Comem dans toutes les bases de données, le code SQLdb dépend de l'unité PostgreSQL spécifique de bas niveau qui enveloppe la bibliothèque du pilote PostgreSQL (.so/.dll/.dylib). Normalement vous pourriez utiliser le code SQLdb de haut niveau car il vous permet de coder plus rapidement et de basculer facilement entre les bases de données, etc.
153	153
154	154		Utiliser ceci est très facile, tout ce dont vous avez besoin est de compiler certaines unités, et d'utiliser ces unités dans votre programme. Vous avez besoin de spécifier l'emplacement de la bibliothèque cliente de PostgreSQL (libpq) pour la compilation et c'est tout.
155	155
156	156		L'unité principale est appelée postgres, normalement c'est la seule unité que vous devez inclure dans votre clause uses.
157	157
158	158		### Exigences
159	159
160	160		Vous avez besoin d'au moins la version 0.99.5 de Free Pascal (en pratique toute version de FPC wsauf les extrêmement plus anciennes). Les en-têtes sont traduits de PostgreSQL version 6.3.1.
161	161
162	162		### Installation
163	163
164	164		L'unité postgres vient avec les paquets de Free Pascal et est distribuée avec le compilateur. Celui-ci contient un répertoire postgres avec les unités, un programme de test et un makefile. Accédez à ce répertoire et éditez le Makefile pour définir les variables pour votre système. Vous devez fournir seulement une chose :
165	165
166	166		1. Le répertoire où la bibliothèque libpq réside, habituellement /usr/local/pgsql/lib.
167	167
168	168		En tapant :
169	169
170		-	~~`make`~~
	170	+	```text
	171	+	make
	172	+	```
171	173
172	174		Cela devrait compiler les unités et le programme. Si la compilation a été réussie, vous pouvez installer en tapant :
173	175
174		-	~~`make install`~~
	176	+	```text
	177	+	make install
	178	+	```
175	179
176	180		(Rappelez-vous que le répertoire où les unités devraient être installées.)
177	181
178	182		Vous pouvez alors tester le programme en exécutant :
179	183
180		-	~~`make test`~~
	184	+	```text
	185	+	make test
	186	+	```
181	187
182	188		Cela :
183	189
184	190		- exécutera le programme de test testpg. Il s'agit d'une traduction directe d'un programme d'exemple du Guide du programmeur PostGreSQL.
185	191		- exécutera un script pour créer une table dans la base de données et la remplir avec quelques données, pour cela, le chemin au programme psql doit être dans le PATH de votre système. Par défaut, le base de données utilisée est testdb.
186	192		- exécutera le programme de test testemail
187	193		- lancera un script shell à nouveau pour effacer la table créée.
188	194
189	195		Vous verrez beaucoup de messages sur votre écran, vous donnant des retours d'information et des résultats. Si quelque chose ne va pas, Make vous en informera.
190	196
191	197		Aller vers [[Package List/fr\|Packages List]]
192	198
193	199		## Voir aussi
194	200
195	201		- [[TPSQL/fr\|TPSQL]] - Un ensemble de composants dataset/database pour PostgreSQL alternatif.
196	202		- [[Lazarus DB Faq/fr\|Lazarus DB Faq]] - Plus d'info sur la programmation des SGBDR.
197	203		- [[Lazarus Database Tutorial/fr\|Lazarus Database Tutorial]] - Faire travailler Lazarus avec diverses bases de données.
198	204
199	205		---
200	206		From the Free Pascal wiki, page "postgres/fr", as it stood on 2020-02-23 after a change by Trev, 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).

Back to history