Configuration de l’exécution
La bibliothèque d’exécution libgixsql est configurée par des variables d’environnement. Certaines d’entre elles peuvent aussi être définies par connexion, avec une option de la chaîne de connexion (Options de connexion), qui est alors prioritaire.
Variables d’environnement
| Variable | Défaut | Description |
|---|---|---|
GIXSQL_DEFAULT_DRIVER |
pilote utilisé lorsque la chaîne de connexion n’en nomme aucun (Le pilote par défaut) | |
GIXSQL_AUTOCOMMIT |
native |
on, off ou native (Autocommit) |
GIXSQL_CLIENT_ENCODING |
encodage du client (PostgreSQL, MySQL) | |
GIXSQL_FIXUP_PARAMS |
off |
convertir les marqueurs de paramètres des instructions préparées (Marqueurs de paramètres) |
GIXSQL_NOREC_CODE |
100 |
SQLCODE de la condition « aucun enregistrement » (La condition « aucun enregistrement ») |
GIXSQL_VARYING_LEN_SZ_SHORT |
0 |
1 si les champs de longueur VARYING font 2 octets ; inutile pour les programmes précompilés avec -N 2 |
GIXSQL_LOG_LEVEL |
error |
voir Journalisation |
GIXSQL_LOG_FILE |
gixsql.log |
voir Journalisation |
GIXSQL_LOG_TRUNCATE |
off |
voir Journalisation |
GIXSQL_LOG_ROTATE |
off |
voir Journalisation |
GIXSQL_LOG_ROTATE_MAX_SIZE |
10M |
voir Journalisation |
GIXSQL_LOG_ROTATE_MAX_FILES |
5 |
voir Journalisation |
GIXSQL_LOG_ROTATE_ON_OPEN |
on |
voir Journalisation |
Les variables booléennes acceptent on/off et 1/0.
GIXSQL_USRPWD_SEP est lue par la bibliothèque d’exécution mais n’a aucun effet dans la version actuelle : le séparateur entre le nom d’utilisateur et le mot de passe est toujours un point.
Les pilotes utilisent aussi les variables de leurs bibliothèques clientes, par exemple PGHOST ou PGSSLMODE pour PostgreSQL, NLS_LANG et TNS_ADMIN pour Oracle, ODBCINI pour unixODBC.
Trouver les pilotes
libgixsql charge le pilote libgixsql-<driver>.so (libgixsql-<driver>.dll sous Windows) avec le chargeur dynamique du système. Le répertoire des pilotes doit se trouver dans LD_LIBRARY_PATH (PATH sous Windows), ou dans le chemin des bibliothèques du système.
Journalisation
La bibliothèque d’exécution écrit un journal, avec spdlog.
GIXSQL_LOG_LEVEL-
off,critical,error(par défaut),warn,info,debugoutrace. Le niveautracejournalise chaque appel, avec les valeurs des variables hôtes (y compris les mots de passe et autres données sensibles), et ralentit les programmes. GIXSQL_LOG_FILE-
le fichier journal (
gixsql.logpar défaut, dans le répertoire courant). GIXSQL_LOG_TRUNCATE-
onpour tronquer le fichier journal au démarrage du programme. GIXSQL_LOG_ROTATE-
onpour effectuer la rotation des fichiers journaux. GIXSQL_LOG_ROTATE_MAX_SIZE-
la taille maximale d’un fichier journal, avec un suffixe facultatif
B,K,M(par défaut) ouG(10Mpar défaut). GIXSQL_LOG_ROTATE_MAX_FILES- le nombre de fichiers conservés (5 par défaut).
GIXSQL_LOG_ROTATE_ON_OPEN-
on(par défaut) pour effectuer la rotation au démarrage du programme.
Par exemple, pour tracer un programme :
$ GIXSQL_LOG_LEVEL=trace GIXSQL_LOG_FILE=/tmp/prog.log ./prog