postgres/fr

│ Deutsch (de) │ English (en) │ español (es) │ français (fr) │

Portail de la base de données

Références: Information générale Bibliothèques Types de champ Contrôles FAQ Comment faire en SQL ? Travailler avec TSQLQuery Applications de base de données en mémoire Tutoriels/articles pratiques : Vue d'ensemble 0 - Configuration de la base de données 1 - Commençons 2 - Edition 3 - Requêtes 4 - Modules de données Référence de programmation SQLdb Bases de données Advantage - MySQL - MSSQL - Postgres - Interbase - Firebird - Oracle - ODBC - Paradox - SQLite - dBASE - MS Access - Zeos

Vue d'ensemble

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.

Avantages de PostgreSQL:

• Il est disponible et largement utilisé
• Très stable et a un ensemble complet de fonctionnalités.
• Licence libérale (sans frais) par rapport à MySQL.

Inconvénient de PostgreSQL:

• Certains hébergeurs peuvent ne pas offrir PostgreSQL
• Pas de version incorporée (i.e. sans serveur distant/installé, comme Firebird le propose)

Win64: SVP, consulter l'avertissement ici sur l'inutilisation de certaines versions de FPC/Lazarus Win64.

Accès direct à PostgreSQL

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.

Vous pouvez la télécharger librement depuis Composants Lazarus.

Zeos

Zeos prend en charge PostgreSQL ; veuillez lire ZeosDBO.

SQLDB

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 :

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.

La propriété charset est utilisée pour l'encodage du client.

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 :

PQConnection.Params.Add('port=' + VariableContainingPort);

D'autres paramètres de connexion particuliers peuvent être spécifiés en utilisant la propriéét Params :

PQConnection.Params.Add('application_name=''yourappname''')

Exemple

Voir See 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.

Surveillance des événements

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.

C'est une enveloppe mince autour de FPC PQEventMonitor ; veuillez consulter le programme exemple FPC pqeventstest.pp pour les détails.

Installation et erreurs

Comme pour toutes les unités SQLdb, vous avez besoin de vos bibliothèque cliente (tous les fichiers PostgreSQL .dll/.manifest)

• dans une dossier dans le chemin (de recherche des bibliothèques, tel que c:\windows\system32 pour Windows)
• ou (pour Windows) dans le dossier de votre programme (p.ex. lib\something\ dans votre dossier de projet et le

Pilote Windows 64 bit

Pour développer une application 64 bit, vous devez utiliser une DLL 64 bit (remarque générale).

  Remarque: 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).

Un pilote Windows 64 bit est franchement difficile à trouver mais peut être téléchargé ici : [1]. 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.

Erreur: "Can not load PostgreSQL client library "libpq.dll""

Le programme ne peut pas trouver les fichiers du pilote PostgreSQL.

Voir ci-dessus pour les instructions d'installation des bibliothèques.

Un bon exemple qui démontre comment inclure les fichiers DLL du pilote en connectant Lazarus avec PostgreSQL sous Windows est easyDB.

Sur Linux/Unix/OSX, assurez-vous que les bibliothèques PostgreSQL sont dans le chemin de recherche des bibliothèques, i.e. :

• 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.
• 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 :

  ln -s /usr/lib/pqsql.so.5 /usr/lib/pqsql.so
  

De manière alternative, installez le paquet -dev du client postgresql en utilisant le gestionnaire de paquets de votre distribution.

Problèmes de nettoyage des paramètres

  Remarque: Verify this: is .paramtype really necessary?

At least in FPC <= 2.6.2: if you .Clear a parameter (i.e. set it to NULL), PostgreSQL may have difficulty recognizing the parameter type.

In that case, explicitly specify the type, e.g.:

FWriteQuery.Params.ParamByName('LONGITUDE').ParamType:=ptInput; //required for postgresql
FWriteQuery.Params.ParamByName('LONGITUDE').Clear

Comment faire

Utiliser INSERT RETURNING

Obtenir le dernier ID inséré

With PostGres there is no need to run a second query to get the last inserted ID.

Use INSERT RETURNING and read the value:

var 
  ID: Integer
..
Query.SQL.Text:= 'INSERT INTO myschema.films(film_name)' +
                 'VALUES(:film_name) RETURNING film_id;';
Query.Open;
ID:= Query.FieldByName('film_id').AsInteger;

Obtenir des champs multiples et des expressions

RETURNING in PostgreSQL is more flexible than most database engines. It works with INSERT, UPDATE, and DELETE statements and can be any list of fields, constants, or expressions that would be found in a SELECT list.

INSERT INTO films (film_name) VALUES ('val') RETURNING film_id;  -- Returns id's for newly created rows.
INSERT INTO films (film_name) VALUES ('val') RETURNING film_id, kind;  -- Returns id and kind fields in newly created rows.
INSERT INTO films (film_name) VALUES ('val') RETURNING *; -- Returns all fields in newly created rows.
     
UPDATE films SET kind = 'Dramatic' WHERE kind = 'Drama' RETURNING film_id; -- Returns id's of updated rows.
UPDATE films SET kind = 'Dramatic' WHERE kind = 'Drama' RETURNING film_id, film_name; -- Returns id and film names of updated rows.
UPDATE films SET kind = 'Dramatic' WHERE kind = 'Drama' RETURNING *; -- Returns all fields of updated rows.
     
DELETE FROM films RETURNING film_id; --Returns id's of deleted rows.
DELETE FROM films RETURNING film_id, film_name; --Returns id's and film names of deleted rows.
DELETE FROM films RETURNING *;  -- Returns all fields of deleted rows.

RETURNING using fields, constants, and expressions:

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;

Paquet PostgreSQL : les unités de bas-niveau

As with all databases, the SQLDB code depends on a lower level PostgreSQL specific unit that wraps around the PostgreSQL driver library (.so/.dll/.dylib). Normally, you would use the higher-level SQLDB code as it allows you to code more quickly, easily switch databases etc.

Using this is very easy, all you need to do is compile some units, and use these units in your program. You need to specify the place of the PostgreSQL client Library (libpq) when compiling, and that is it.

The main unit is called postgres, normally this is the only unit you must include in your uses clause.

Exigences

You need at least version 0.99.5 of Free Pascal (basically any version of FPC except extremely old ones). The headers are translated from PostgreSQL version 6.3.1.

Installation

The postgres unit comes with the Free Pascal packages, and is distributed together with the compiler. This contains a directory postgres with the units, a test program and a makefile. cd to the directory and edit the Makefile to set the variables for your system. You must provide only 1 thing:

1. The directory where the libpq library resides, usually /usr/local/pgsql/lib

Typing

make

Should compile the units and the program. If compilation was succesfull, you can install with

make install

(Remember to set the directory where the units should be installed.)

You can then test the program by running

make test

This will:

• Run the test program testpg. It is a straightforward pascal translation of the example program in the PostGreSQL programmers' guide.
• Run a script to create a table in a database, and fill it with some data. (the psql program should be in your PATH for this) . By default, the used database is testdb.
• Run the testprogram testemail
• Run a shell script again to remove the created table.

You will see a lot of messages on your screen, giving you feedback and results. If something went wrong, make will inform you of this.

Go back to Packages List

Voir aussi

• TPSQL - Un ensemble de composants dataset/database pour PostgreSQL alternatif.
• Lazarus DB Faq - Plus d'info sur la programmation des SGBDR.
• Lazarus Database Tutorial - Faire travailler Lazarus avec diverses bases de données.