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.
DATASRCcontient 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 contientuser/password, n’est pas supportée : utilisezIDENTIFIED 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 :
- le pilote choisi lors de la compilation de GixSQL (
configure --with-default-driver=...), s’il y en a un ; - 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.
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
COMMITet chaqueROLLBACK.
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.
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.