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.

Avertissement

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, debug ou trace. Le niveau trace journalise 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.log par défaut, dans le répertoire courant).
GIXSQL_LOG_TRUNCATE
on pour tronquer le fichier journal au démarrage du programme.
GIXSQL_LOG_ROTATE
on pour 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) ou G (10M par 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