Connexions et transactions

Connexion à une base de données

GixSQL n’a pas d’étape de « bind » : un programme doit se connecter explicitement avec une instruction CONNECT avant d’exécuter toute autre instruction SQL. Les formes suivantes sont acceptées, où chaque opérande est soit une variable hôte (:VAR), soit une chaîne littérale :

           EXEC SQL CONNECT TO :DATASRC END-EXEC.
           EXEC SQL CONNECT TO :DATASRC USER :USR-PWD END-EXEC.
           EXEC SQL CONNECT TO :DATASRC USER :USR USING :PWD END-EXEC.
           EXEC SQL CONNECT :USR IDENTIFIED BY :PWD USING :DATASRC END-EXEC.
           EXEC SQL CONNECT USING :DATASRC END-EXEC.
  • DATASRC contient une chaîne de connexion (Chaînes de connexion).
  • Le nom d’utilisateur et le mot de passe sont donnés soit séparément, soit dans une seule donnée sous la forme user.password (un point les sépare).
  • Avec CONNECT USING, les identifiants doivent figurer dans la chaîne de connexion.
  • La forme Pro*COBOL CONNECT :USR-PWD, où une seule donnée contient user/password, n’est pas supportée : utilisez IDENTIFIED BY.

Après le CONNECT, SQLCODE vaut 0 en cas de succès. En cas d’échec, il est négatif et SQLERRMC contient le message de la base de données.

Chaînes de connexion

Le format général d’une chaîne de connexion est :

<driver>://[<user>.<password>@]<host>[:<port>][/<database>][?<opt>=<val>[&<opt>=<val>]...]

où <driver> est l’un de pgsql, oracle, mysql, odbc, sqlite (voir Vue d’ensemble des backends). Exemples :

pgsql://localhost:5432/demo
pgsql://demo.secret@dbserver/demo?default_schema=app
oracle://dbserver:1521/FREEPDB1
mysql://localhost:3306/demo
odbc://MYDSN
sqlite:///var/data/demo.db

Deux autres formats sont acceptés, sans le nom du pilote :

  • [<user>.<password>@]<host>[:<port>][/<database>]
  • <database>@<host>[:<port>] (le format d’OCESQL)

Le pilote par défaut

Lorsque la chaîne de connexion ne nomme pas de pilote, GixSQL utilise le pilote par défaut, qui est :

  1. le pilote choisi lors de la compilation de GixSQL (configure --with-default-driver=...), s’il y en a un ;
  2. sinon, le contenu de la variable d’environnement GIXSQL_DEFAULT_DRIVER.

S’il n’y a pas de pilote par défaut, le CONNECT échoue.

Options de connexion

Les options suivent un ? à la fin de la chaîne de connexion, séparées par &. Les options booléennes acceptent on/off ou 1/0.

Option Pilotes Description
autocommit tous on, off ou native (Autocommit)
client_encoding pgsql, mysql encodage du client, par exemple UTF8 (PostgreSQL) ou utf8mb4 (MySQL)
fixup_params tous convertir les marqueurs de paramètres des instructions préparées (Marqueurs de paramètres)
default_schema pgsql le search_path (un ou plusieurs schémas, séparés par des virgules)
native_cursors pgsql utiliser les curseurs natifs de PostgreSQL (par défaut on)
decode_binary pgsql décoder les valeurs bytea (par défaut on)
updatable_cursors mysql, sqlite émuler les curseurs modifiables
sslmode, sslcert, … pgsql transmises à libpq (PostgreSQL)

Plusieurs options peuvent aussi être définies par des variables d’environnement (Configuration de l’exécution) ; l’option de la chaîne de connexion est prioritaire.

Connexions multiples

Un programme peut ouvrir plusieurs connexions, chacune avec un nom :

           EXEC SQL
               CONNECT TO :DATASRC-1 AS CONN1 USER :DBUSR-1
           END-EXEC.
           EXEC SQL
               CONNECT TO :DATASRC-2 AS CONN2 USER :DBUSR-2
           END-EXEC.

ou, avec la syntaxe Pro*COBOL :

           EXEC SQL
               CONNECT :USR IDENTIFIED BY :PWD AT CONN2 USING :DATASRC-2
           END-EXEC.

Une instruction est alors exécutée sur une connexion donnée avec la clause AT :

           EXEC SQL AT CONN1 DELETE FROM TAB1 END-EXEC.
           EXEC SQL AT CONN2 DELETE FROM TAB2 END-EXEC.

Les instructions sans AT utilisent la connexion par défaut, celle ouverte sans nom.

NoteÀ vérifier

Quelle est la connexion par défaut lorsque toutes les connexions sont nommées ?

Déconnexion

           EXEC SQL CONNECT RESET END-EXEC.
           EXEC SQL CONNECT RESET CONN1 END-EXEC.
           EXEC SQL DISCONNECT ALL END-EXEC.

Les programmes Pro*COBOL se déconnectent avec COMMIT WORK RELEASE ou ROLLBACK WORK RELEASE : voir Migrer depuis Pro*COBOL.

Transactions

Une transaction est une suite d’instructions SQL qui sont validées (COMMIT) ou annulées (ROLLBACK) ensemble. Elle se termine par :

           EXEC SQL COMMIT WORK END-EXEC.
           EXEC SQL ROLLBACK WORK END-EXEC.

SAVEPOINT name et ROLLBACK TO SAVEPOINT name sont transmises telles quelles à la base de données.

Autocommit

La manière dont les transactions commencent dépend du mode autocommit, défini par l’option autocommit de la chaîne de connexion ou par la variable d’environnement GIXSQL_AUTOCOMMIT :

native (par défaut)
la connexion utilise le comportement par défaut de la base de données : autocommit pour PostgreSQL, MySQL et ODBC, transactions explicites pour Oracle.
on
chaque instruction réussie est validée.
off
une transaction est démarrée lors de la connexion, puis une nouvelle après chaque COMMIT et chaque ROLLBACK.
Important

Sous PostgreSQL, les curseurs natifs (par défaut) n’existent qu’à l’intérieur d’une transaction : en mode autocommit, un DECLARE CURSOR échoue. Les programmes qui utilisent des curseurs doivent soit démarrer explicitement des transactions (EXEC SQL START TRANSACTION END-EXEC), soit s’exécuter avec GIXSQL_AUTOCOMMIT=off, qui est le comportement attendu par les programmes Pro*COBOL.

NoteÀ vérifier

L’ancien README indique que la valeur par défaut est off, le code (GIXSQL_AUTOCOMMIT_DEFAULT dans runtime/libgixsql/gixsql.h) indique native. Vérifier le comportement réel de chaque pilote en mode native.