Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Dieser Artikel zeigt Ihnen, wie Sie den unixODBC Driver Manager Trace unter Linux und macOS konfigurieren. Die Trace zeichnet ODBC API-Aufrufe auf, die Sie über den Driver Manager ausführen. Es verfolgt nicht die internen Ereignisse des Microsoft ODBC-Treibers. Für den Unterschied zwischen diagnostischen Datensätzen und Tracing-Ebenen siehe ODBC-Diagnostik.
Der [ODBC] Abschnitt von odbcinst.ini steuert die Ablaufverfolgung für Anwendungen, die die unixODBC-Systemkonfiguration verwenden. Setzen Sie Trace=Yes und spezifizieren Sie einen absoluten Pfad für TraceFile:
[ODBC]
Trace=Yes
TracePid=No
TraceFile=/home/myappuser/odbc-trace.ABC123/odbc.log
Der Pfad ist beispielhaft; verwenden Sie den privaten absoluten Pfad, der im folgenden Verfahren generiert wird.
Bewahren Sie die Treiberregistrierungseinträge auf, die Ihre Anwendung in dieser odbcinst.ini Datei verlangt. Der Abschnitt [ODBC] ist global zur Konfiguration. Das Hinzufügen von Trace=Yes zu einem treiberspezifischen Abschnitt grenzt den unixODBC Driver Manager-Trace nicht auf diesen Treiber ein.
Der Standardpfad für die Trace-Datei ist nicht auf Ihre Anwendung begrenzt. Verwenden Sie stattdessen ein privates Verzeichnis und einen expliziten Trace-Dateipfad. Das Nachverfolgen kann die Leistung beeinflussen, und die Ausgabe kann Anwendungsdaten enthalten. Beschränke den Zugriff auf die Datei und zeichne nur die Aufrufe auf, die du benötigst.
Verwende einen unixODBC-Build, der den Upstream-Diagnose-Trace-Buffer-Fix enthält. Herstellerpakete können einen Backport enthalten; überprüfen Sie die Patches des Pakets, anstatt sich nur auf die Versionsnummer zu verlassen. Ohne den Fix kann die Anwendung in SQLGetDiagRec abbrechen, während der Manager einen nativen Fehler zur Nachverfolgung formatiert.
Start einer Anwendung nachverfolgen
Öffnen Sie eine dedizierte Bash-Shell und führen Sie dann die Shell-Befehle in diesem Verfahren in derselben Terminalsitzung aus. Der erste Befehl ermöglicht eine Fail-Fast-Behandlung, sodass eine fehlgeschlagene Verzeichniserstellung, Berechtigungsänderung oder Konfigurationskopie den Start der Anwendung verhindert. Lassen Sie die Shell für die späteren Schritte offen und tippen Sie exit nach der Bereinigung.
Führen Sie
odbcinst -jaus und notieren Sie die Pfade für den Systemtreiber und die Systemdatenquellendateien. Erstelle private Konfigurations- und Trace-Verzeichnisse und kopiere dann die Systemkonfigurationsdateien. Ersetzen Sie die Beispiel-Dateipfade durch die, die auf Ihrem System gemeldet werden: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"Die gepinnte unixODBC-Trace-Konfigurationsimplementierung liefert einen 64-Byte-Puffer für den Registrierungsprofilleser. Dieser Reader kopiert sicher einen Pfad von bis zu 62 Bytes und dessen Null-Terminator. Bei längeren Pfaden fügt sein Abschneidungszweig keinen Null-Terminator hinzu. Überprüfungen mit unixODBC 2.3.14 unter Linux und macOS bestätigten die korrekte Trace-Erstellung bei 62 Bytes. Der Guard zählt Bytes und stoppt vor dem Start, wenn der generierte Pfad zu lang ist. Wenn es stoppt, verwenden Sie einen kürzeren beschreibbaren übergeordneten Pfad im
trace_dir-Befehl, behalten Siemktemp -dbei, und starten Sie das Verfahren neu.Bewahren Sie alle Fahrerregistrierungseinträge, die die Anwendung benötigt, in der kopierten
odbcinst.iniauf. Wenn die Anwendung einen Systemdatenquellennamen (DSN) verwendet, behalten Sie dessen Definition im kopiertenodbc.inibei. Wenn seinDriverWert ein Registrierungsname ist, behalte diese entsprechende Definition im kopiertenodbcinst.ini. Wenn der Wert ein absoluter Bibliothekspfad ist, bestätigen Sie, dass die Bibliothek existiert und auf diesem Pfad zugänglich ist. Bei der angepinnten unixODBC-Version wird ein Wert, der mit/beginnt, als Bibliothekspfad verwendet; andere Werte werden durch eine Treiberregistrierung aufgelöst. Weitere Informationen finden Sie im unixODBC-odbc.ini-Handbuch und in der angepinnten Implementierung der Treibersuche. Die Befehle lassen die DSN-Konfiguration des Benutzers erhalten.Fügen Sie im privaten
odbcinst.ini-Bereich den globalen[ODBC]-Abschnitt hinzu oder aktualisieren Sie ihn. Verwenden Sie den absoluten Pfad, der vom vorherigen BefehlTraceFileausgedruckt wurde; erstellen Sie keinen zweiten[ODBC]Abschnitt:[ODBC] Trace=Yes TracePid=No TraceFile=/home/myappuser/odbc-trace.ABC123/odbc.logErsetzen Sie den Beispielpfad durch den exakten Pfad, der im vorherigen Schritt gedruckt wurde. Setzen Sie
TracePid=Noselbst dann, wenn die kopierte Konfiguration es aktiviert, sodass der Trace die hier gezeigte einzelne Datei verwendet.Starten Sie die Anwendung mit dem privaten Systemkonfigurationsverzeichnis:
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 fiDie Trace-Datei sollte ODBC-API-Aufrufe und deren Rückgabecodes enthalten. Das Bedingungskonstrukt hält die Shell für die Bereinigung offen, selbst wenn die Anwendung mit einem Fehler endet. Der unixODBC Driver Manager liest sein Systemkonfigurationsverzeichnis aus
ODBCSYSINI. Setzen SieODBCINSTINI=odbcinst.inifür diesen untergeordneten Vorgang, damit eine geerbte Überschreibung des Registrierungsdateinamens die kopierte Datei nicht umgeht. Für die Dateinamensuche siehe die angepinnte unixODBC-Konfigurationsimplementierung.ODBCSEARCH=ODBC_BOTH_DSNüberschreibt für diesen Start einen vererbten Benutzer- oder Nur-System-DSN-Suchmodus. Diese Einstellungen lassen die bestehende Benutzer-DSN-Datei erhalten. unixODBC durchsucht sowohl System- als auch Benutzer-DSN-Dateien, und das Benutzer-DSN hat Vorrang, wenn derselbe Name in beiden vorkommt. Prüfen Sie auf eine doppelte Benutzer-DSN, wenn die Anwendung anscheinend andere Einstellungen verwendet als die kopierte System-DSN. Wenn die Anwendung absichtlich einen eingeschränkten Suchmodus benötigt, bewahre diesen Modus stattdessen und prüfe, ob die ausgewählte DSN-Datei die erforderliche Definition enthält. Weitere Informationen finden Sie in der angepinnten unixODBC-Suchmodus-Implementierung, dem iSQL-Handbuch und dem odbc.ini-Handbuch.
Wenn die Wiedergabe endet, schließen Sie die Anwendung ab, um ihre ODBC-Umgebungshandles freizugeben. Setze Trace=No oder entferne die [ODBC] Nachverfolgungseinstellungen vor einem weiteren Start. Beschränken Sie den Zugriff auf das Protokoll, bevor Sie es inspizieren oder teilen:
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
Eine Anwendung, die nicht startet oder sich beendet, bevor eine ODBC-Umgebung allokiert wird, erstellt möglicherweise keine Trace-Datei. Der Check meldet die fehlende Datei und hält die Bereinigung in der dedizierten Shell erreichbar.
Schwärzen Sie sensible Inhalte, bevor Sie den Trace teilen. Lösche das Protokoll, wenn du es nicht mehr brauchst. Entferne die privaten Konfigurationsdateien und Verzeichnisse nur, wenn du sie für diesen Trace erstellt hast und deren Inhalt nicht mehr brauchst.
Die folgenden Befehle entfernen nur die in diesem Verfahren erstellten Dateien und Verzeichnisse:
rm -f "$trace_dir/odbc.log" "$config_dir/odbcinst.ini" "$config_dir/odbc.ini"
rmdir "$trace_dir" "$config_dir"
Finden Sie die Konfigurationsdateien, die vom Treibermanager verwendet werden
Führen Sie odbcinst -j aus, um die System- und Benutzerkonfigurationspfade anzuzeigen. Wege können je nach Plattform und unixODBC-Build variieren.
Benutzer-DSNs stehen einem bestimmten Nutzer zur Verfügung.
System-DSNs stehen den Nutzern auf dem System zur Verfügung, und deren Verwaltung kann Administratorrechte erfordern. Wenn in beiden Dateien derselbe DSN-Name existiert, hat das Benutzer-DSN Vorrang. Weitere Informationen finden Sie in der unixODBC-Dokumentation.