Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
ODBC-stuurprogramma downloaden
Dit artikel laat zien hoe je de unixODBC Driver Manager-trace configureert op Linux en macOS. De traces registreren ODBC API-aanroepen die je via de Driver Manager doet. Het traceert de interne gebeurtenissen van de Microsoft ODBC-driver niet. Voor het verschil tussen diagnostische records en traceerlagen, zie ODBC diagnostiek.
De [ODBC]-sectie van odbcinst.ini beheert tracering voor applicaties die de unixODBC-systeemconfiguratie gebruiken. Stel Trace=Yes in en specificeer een absoluut pad voor TraceFile:
[ODBC]
Trace=Yes
TracePid=No
TraceFile=/home/myappuser/odbc-trace.ABC123/odbc.log
Het pad is illustratief; gebruik het private absolute pad dat in de volgende procedure wordt gegenereerd.
Bewaar de registratie-vermeldingen die je applicatie vereist in dit odbcinst.ini bestand. De [ODBC] sectie is van toepassing op de hele configuratie. Toevoegen van Trace=Yes aan een driverspecifieke sectie beperkt de unixODBC Driver Manager-trace niet tot die driver.
Het standaard trace-file pad is niet gebonden aan je applicatie. Gebruik in plaats daarvan een privémap en een expliciet trace-bestandpad. Tracing kan de prestaties beïnvloeden, en de output kan applicatiegegevens bevatten. Beperk de toegang tot het bestand en leg alleen de oproepen vast die je nodig hebt.
Gebruik een unixODBC-build die de upstream diagnostische trace buffer-fix bevat. Leverancierspakketten kunnen een backport bevatten; controleer de patches van het pakket in plaats van alleen op het versienummer te vertrouwen. Zonder deze oplossing kan de applicatie worden afgebroken in SQLGetDiagRec terwijl de manager een native fout voor het traceren opmaakt.
Eén applicatiestart traceren
Open een speciale Bash-shell en voer vervolgens de shell-commando's uit in deze procedure in diezelfde terminalsessie. Het eerste commando maakt fail-fast handling mogelijk, zodat het proces bij een mislukte directorycreatie, wijziging van rechten of configuratiekopie stopt voordat de applicatie wordt gestart. Houd de shell open voor de latere stappen en typ exit na het schoonmaken.
Voer
odbcinst -juit en noteer de paden voor de systeemdriver en de systeemgegevensbronbestanden. Maak privéconfiguratie- en trace-mappen aan, kopieer vervolgens de systeemconfiguratiebestanden. Vervang de voorbeeldbestandspaden door de bestandspaden die op je systeem worden gerapporteerd: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"De vastgezette unixODBC traceconfiguratie-implementatie levert een buffer van 64 bytes aan de registratieprofiellezer. Die lezer kopieert veilig een pad van maximaal 62 bytes plus de null-terminator daarvan. Voor langere paden voegt de afkappingsbranch geen null-terminator toe. Controles met unixODBC 2.3.14 op Linux en macOS bevestigden correcte tracecreatie bij 62 bytes. De guard telt bytes en stopt voor lancering als het gegenereerde pad te lang is. Als het stopt, gebruik dan een korter beschrijfbaar ouderpad in het
trace_dircommando, houdmktemp -d, en start de procedure opnieuw.Bewaar alle chauffeursregistratiegegevens die de aanvraag nodig heeft in de gekopieerde
odbcinst.ini. Als de applicatie een systeemgegevensbronnaam (DSN) gebruikt, houd dan de definitie ervan in de gekopieerdeodbc.ini. Als deDriverwaarde een registratienaam is, bewaar dan die overeenkomende definitie in de gekopieerdeodbcinst.ini. Als de waarde een absoluut bibliotheekpad is, bevestig dan dat de bibliotheek bestaat en toegankelijk is op dat pad. Bij de vastgezette unixODBC-revisie wordt een waarde die begint met/gebruikt als bibliotheekpad; andere waarden worden opgelost via een driverregistratie. Voor meer informatie, zie de unixODBC odbc.ini-handleiding en de vastgepinde driverzoekimplementatie. De commando's laten de DSN-configuratie van de gebruiker ongewijzigd.Voeg in de private
odbcinst.inisectie de globale[ODBC]sectie toe of werk deze bij. Gebruik het absolute pad dat door het vorige commando is afgedrukt voorTraceFile; maak geen tweede[ODBC]sectie aan:[ODBC] Trace=Yes TracePid=No TraceFile=/home/myappuser/odbc-trace.ABC123/odbc.logVervang het voorbeeldpad door het exacte pad dat in de vorige stap is afgedrukt. Stel
TracePid=Noin, zelfs als de gekopieerde configuratie het mogelijk maakt, zodat de trace het enkele bestand gebruikt dat hier wordt getoond.Start de applicatie met de private systeemconfiguratiemap:
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 fiHet tracebestand moet ODBC API-aanroepen en hun retourcodes bevatten. De conditionele instructie houdt de shell open voor opruiming, zelfs als de applicatie met een foutmelding afsluit. De unixODBC Driver Manager leest zijn systeemconfiguratiemap uit
ODBCSYSINI. StelODBCINSTINI=odbcinst.iniin voor dit kindproces zodat een override van geërfde registratie-bestandsnaam het gebruik van het gekopieerde bestand niet omzeilt. Voor het opzoeken van de bestandsnaam, zie de vastgezette unixODBC-configuratie-implementatie.ODBCSEARCH=ODBC_BOTH_DSNoverschrijft een geërfde gebruikers- of alleen systeem-DSN-zoekmodus voor deze start. Deze instellingen laten het bestaande gebruikers-DSN-bestand behouden. unixODBC doorzoekt zowel systeem- als gebruikers-DSN-bestanden, en de gebruiker DSN krijgt voorrang wanneer dezelfde naam in beide voorkomt. Controleer of er een dubbele gebruikers-DSN is als de applicatie andere instellingen lijkt te gebruiken dan de gekopieerde systeem-DSN. Als de applicatie opzettelijk een beperkte zoekmodus vereist, behoud dan die modus in plaats daarvan en controleer of het geselecteerde DSN-bestand de vereiste definitie bevat. Voor meer informatie, zie de vaste unixODBC zoekmodus-implementatie, de isql-handleiding en odbc.ini-handleiding.
Wanneer de uitvoering eindigt, sluit je de applicatie af om de ODBC-omgevingshandles vrij te geven. Stel Trace=No in of verwijder de [ODBC] tracing-instellingen voor een nieuwe start. Beperk de toegang tot het logboek voordat je het inspecteert of deelt:
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
Een applicatie die niet start of afsluit voordat een ODBC-omgeving wordt toegewezen, maakt mogelijk geen trace-bestand aan. De controle meldt het ontbrekende bestand en houdt de opruiming bereikbaar in de aparte shell.
Maak gevoelige inhoud onleesbaar voordat je de trace deelt. Verwijder het logboek wanneer je het niet meer nodig hebt. Verwijder de privé-configuratiebestanden en mappen alleen als je ze voor deze trace hebt aangemaakt en hun inhoud niet meer nodig hebt.
De volgende commando's verwijderen alleen de bestanden en mappen die in deze procedure zijn aangemaakt:
rm -f "$trace_dir/odbc.log" "$config_dir/odbcinst.ini" "$config_dir/odbc.ini"
rmdir "$trace_dir" "$config_dir"
Zoek de configuratiebestanden die door de Driver Manager worden gebruikt.
Voer odbcinst -j uit om de systeem- en gebruikersconfiguratiepaden weer te geven. Paden kunnen per platform en unixODBC-build verschillen.
Gebruikers-DSN's zijn beschikbaar voor een specifieke gebruiker.
Systeem-DSN's zijn beschikbaar voor gebruikers op het systeem, en het beheren ervan kan beheerdersrechten vereisen. Wanneer dezelfde DSN-naam in beide bestanden voorkomt, krijgt de gebruikers-DSN voorrang. Zie de unixODBC-documentatie voor meer informatie.