PostgreSQL

Prérequis

  • Compilation : les fichiers de développement de libpq (libpq-dev), trouvés avec pkg-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 UTF8 ou LATIN1.
native_cursors
on (par défaut) pour utiliser les curseurs de PostgreSQL (DECLARE ... CURSOR, FETCH) ; off pour 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 valeurs bytea ; off pour 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, service sont 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 (ou GIXSQL_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).