PostgreSQL
Prérequis
- Compilation : les fichiers de développement de
libpq(libpq-dev), trouvés avecpkg-config. - Exécution :
libpq.
Chaîne de connexion
pgsql://[user.password@]host[:port]/database[?options]
Exemple :
pgsql://localhost:5432/demo?default_schema=app&autocommit=off
Le nom d’utilisateur et le mot de passe sont généralement donnés dans l’instruction CONNECT. Les variables d’environnement de libpq (PGHOST, PGPORT, PGPASSWORD, PGSSLMODE…) et le fichier ~/.pgpass sont pris en compte par libpq pour ce que la chaîne de connexion ne précise pas.
Options
default_schema-
les schémas du
search_path, séparés par des virgules. client_encoding-
l’encodage du client, par exemple
UTF8ouLATIN1. native_cursors-
on(par défaut) pour utiliser les curseurs de PostgreSQL (DECLARE ... CURSOR,FETCH) ;offpour exécuter la requête à l’ouverture du curseur et conserver toutes les lignes en mémoire. decode_binary-
on(par défaut) pour décoder les valeursbytea;offpour les recevoir dans leur encodage textuel (plus volumineux). - Options de libpq
-
hostaddr,connect_timeout,application_name,keepalives,keepalives_idle,keepalives_interval,keepalives_count,sslmode,requiressl,sslcert,sslkey,sslrootcert,sslcrl,krbsrvname,gsslib,servicesont transmises à libpq. Voir la documentation de libpq.
Curseurs et transactions
Les curseurs natifs n’existent qu’à l’intérieur d’une transaction. Avec le mode autocommit par défaut, chaque instruction constitue sa propre transaction, et OPEN échoue. Il faut donc :
- démarrer une transaction avant d’ouvrir le curseur (
EXEC SQL START TRANSACTION END-EXEC), ou - se connecter avec
autocommit=off(ouGIXSQL_AUTOCOMMIT=off), ou - utiliser des curseurs émulés (
native_cursors=off).
Exécuter des programmes Oracle
Voir Migrer depuis Pro*COBOL pour l’extension orafce et le chemin de recherche.
Tests
NoteÀ compléter
Comment mettre en place une base de données de test (image Docker, orafce).