Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Cet article vous montre comment configurer la trace du gestionnaire de pilotes unixODBC sur Linux et macOS. La trace enregistre les appels API ODBC que vous effectuez via le gestionnaire de pilotes. Il ne trace pas les événements internes du pilote ODBC Microsoft. Pour la différence entre les enregistrements de diagnostic et les couches de traçage, voir diagnostics ODBC.
La section [ODBC] de odbcinst.ini contrôle le traçage pour les applications utilisant la configuration système unixODBC. Définissez Trace=Yes et spécifiez un chemin absolu pour TraceFile:
[ODBC]
Trace=Yes
TracePid=No
TraceFile=/home/myappuser/odbc-trace.ABC123/odbc.log
Le chemin est illustratif ; utilisez le chemin absolu privé généré dans la procédure suivante.
Conservez les entrées d’enregistrement du pilote que votre application exige dans ce odbcinst.ini fichier. La [ODBC] section est globale à la configuration. Ajouter Trace=Yes à une section spécifique au pilote ne limite pas la trace du gestionnaire de pilotes unixODBC à ce pilote.
Le chemin du fichier de trace par défaut n’est pas spécifique à votre application. Utilisez plutôt un répertoire privé et un chemin de fichier de trace explicite. Le traçage peut affecter la performance, et la sortie peut contenir des données d’application. Restreignez l’accès au fichier et ne capturez que les appels dont vous avez besoin.
Utilisez une compilation unixODBC qui inclut la correction du tampon de trace de diagnostic du projet amont. Les packages du fournisseur peuvent inclure un backport ; vérifier les correctifs du package au lieu de se fier uniquement au numéro de version. Sans ce correctif, l’application peut s’interrompre dans SQLGetDiagRec lorsque le gestionnaire formate une erreur native à des fins de traçage.
Tracer un lancement de l’application
Ouvrez un shell Bash dédié, puis exécutez les commandes shell dans cette procédure lors de cette même session terminale. La première commande active la gestion des erreurs fatales immédiates (fail-fast), de sorte qu’un échec lors de la création d’un répertoire, de la modification des autorisations ou de la copie de la configuration entraîne l’arrêt du processus avant le lancement de l’application. Gardez le shell ouvert pour les étapes suivantes et tapez exit après nettoyage.
Exécutez
odbcinst -jet notez les chemins d’accès aux fichiers du pilote système et de la source de données système. Créez des répertoires privés de configuration et de traces, puis copiez les fichiers de configuration système. Remplacez les chemins de fichiers exemples par ceux rapportés sur votre système :set -eu config_dir=$(mktemp -d "$HOME/odbc-trace-config.XXXXXX") trace_dir=$(mktemp -d "$HOME/odbc-trace.XXXXXX") if [ "$(printf '%s' "$trace_dir/odbc.log" | wc -c)" -gt 62 ]; then printf 'Use a shorter parent path for the trace directory (log path exceeds 62 bytes).\n' >&2 rmdir "$trace_dir" "$config_dir" exit 1 fi driver_file=/etc/odbcinst.ini data_sources_file=/etc/odbc.ini chmod 700 "$config_dir" "$trace_dir" cp "$driver_file" "$config_dir/odbcinst.ini" if [ -f "$data_sources_file" ]; then cp "$data_sources_file" "$config_dir/odbc.ini" else printf '[ODBC Data Sources]\n' > "$config_dir/odbc.ini" fi chmod 600 "$config_dir/odbcinst.ini" "$config_dir/odbc.ini" printf '%s\n' "$trace_dir/odbc.log"L’implémentation de configuration de trace unixODBC épinglée fournit un tampon de 64 octets au lecteur de profil d’enregistrement. Ce lecteur copie en toute sécurité un chemin allant jusqu’à 62 octets et son terminateur nul. Pour les chemins plus longs, sa branche de troncature n’ajoute pas de caractère de fin nul. Des vérifications avec unixODBC 2.3.14 sur Linux et macOS ont confirmé la création correcte de la trace à 62 octets. Le mécanisme de vérification compte les octets et s’arrête avant le lancement si le chemin généré est trop long. Si cela s’arrête, utilisez un chemin parent accessible en écriture plus court dans la commande
trace_dir, conservezmktemp -d, et redémarrez la procédure.Conservez toutes les entrées d’inscription des pilotes dont l’application a besoin dans le fichier
odbcinst.inicopié. Si l’application utilise un nom de source de données système (DSN), conservez sa définition dans le fichierodbc.inicopié. Si sa valeurDriverest un nom d’inscription, conservez la définition correspondante dans le fichierodbcinst.inicopié. Si la valeur est un chemin de bibliothèque absolu, confirmez que la bibliothèque existe et est accessible à ce chemin. Lors de la révision unixODBC épinglée, une valeur commençant par/est utilisée comme chemin de bibliothèque ; les autres valeurs sont résolues via un enregistrement du pilote. Pour plus d’informations, consultez le manuel unixODBC odbc.ini et l’implémentation de recherche de pilotes épinglée. Les commandes laissent la configuration DSN de l’utilisateur en place.Dans la section privée
odbcinst.ini, ajoutez ou mettez à jour la section globale[ODBC]. Utilisez le chemin absolu imprimé par la commande précédente pourTraceFile; ne créez pas une seconde[ODBC]section :[ODBC] Trace=Yes TracePid=No TraceFile=/home/myappuser/odbc-trace.ABC123/odbc.logRemplacez le chemin de l’exemple par le chemin exact imprimé à l’étape précédente. Définissez
TracePid=Nomême si le fichier de configuration copié l’active, afin que le traçage utilise l’unique fichier présenté ici.Lancez l’application avec le répertoire privé de configuration système :
if (umask 077; ODBCSYSINI="$config_dir" ODBCINSTINI=odbcinst.ini \ ODBCSEARCH=ODBC_BOTH_DSN ./your-app); then : else app_status=$? printf 'Application exited with status %s\n' "$app_status" >&2 fiLe fichier trace doit contenir les appels API ODBC et leurs codes de retour. La condition permet de garder le shell ouvert pour effectuer le nettoyage, même si l’application se termine avec une erreur. Le gestionnaire de pilotes unixODBC lit son répertoire de configuration système depuis
ODBCSYSINI. DéfinissezODBCINSTINI=odbcinst.inipour ce processus enfant afin qu’une éventuelle substitution du nom de fichier d’inscription héritée ne contourne pas le fichier copié. Pour connaître la méthode de recherche du nom de fichier, consultez l’implémentation de la configuration unixODBC épinglée.ODBCSEARCH=ODBC_BOTH_DSNremplace un mode de recherche des DSN hérité, limité à l’utilisateur ou au système, pour ce lancement. Ces paramètres laissent le fichier DSN utilisateur existant en place. unixODBC recherche à la fois dans les fichiers DSN système et utilisateur, et le DSN utilisateur prend la priorité lorsque le même nom existe dans les deux. Vérifiez s’il y a un DSN utilisateur en double si l’application semble utiliser des paramètres différents de ceux du DSN système copié. Si l’application nécessite intentionnellement un mode de recherche restreint, conservez ce mode à la place et vérifiez que le fichier DSN sélectionné contient la définition requise. Pour plus d’informations, consultez l’implémentation du mode de recherche unixODBC épinglée, le manuel isql et le manuel odbc.ini.
Lorsque la reproduction du problème est terminée, quittez l’application pour libérer ses handles d’environnement ODBC. Définissez Trace=No ou supprimez les paramètres de traçage [ODBC] avant un nouveau lancement. Restreignez l’accès au journal avant de l’inspecter ou de le partager :
if [ -f "$trace_dir/odbc.log" ]; then
chmod 600 "$trace_dir/odbc.log"
else
printf 'No trace file was created. Check that the application started and allocated an ODBC environment.\n' >&2
fi
Une application qui ne démarre pas ou se termine avant d’allouer un environnement ODBC peut ne pas créer de fichier trace. Le contrôle signale le fichier manquant et maintient le nettoyage accessible dans le shell dédié.
Expurgez le contenu sensible avant de partager la trace. Supprimez le journal quand vous n’en aurez plus besoin. Supprimez les fichiers de configuration privés et les répertoires uniquement si vous les avez créés pour cette trace et que vous n’avez plus besoin de leur contenu.
Les commandes suivantes suppriment uniquement les fichiers et répertoires créés dans cette procédure :
rm -f "$trace_dir/odbc.log" "$config_dir/odbcinst.ini" "$config_dir/odbc.ini"
rmdir "$trace_dir" "$config_dir"
Trouvez les fichiers de configuration utilisés par le Driver Manager
Exécutez odbcinst -j pour afficher les chemins de configuration système et utilisateur. Les chemins peuvent varier selon la plateforme et la version de compilation d’unixODBC. Les DSN utilisateur ne sont accessibles qu’à un utilisateur spécifique. Les DSN système sont disponibles pour les utilisateurs du système, et leur gestion peut nécessiter des autorisations d’administrateur. Lorsque le même nom DSN existe dans les deux fichiers, le DSN utilisateur a la priorité. Pour plus d’informations, consultez la documentation unixODBC.