Veelgestelde vragen over ODBC op Linux en macOS

ODBC-stuurprogramma downloaden

Dit artikel beantwoordt veelgestelde vragen over het installeren, verbinden met en ontwikkelen van applicaties voor de Microsoft ODBC Driver voor SQL Server on Linux en macOS.

Over het stuurprogramma

Welke ODBC-driverversie moet ik gebruiken?

Gebruik Microsoft ODBC Driver 18 voor SQL Server, de huidige driverlijn, voor nieuwe ontwikkelprojecten. Microsoft ODBC Driver 17 voor SQL Server blijft ondersteund voor applicaties die het al implementeren, zoals beschreven in het ondersteuningslevenscyclusbeleid.

De wijziging die de meeste applicaties treft, is dat Driver 18 standaard verbindingen versleutelt. Voor alle verschillen, zie verschillen tussen hoofdversies.

Welke besturingssystemen en processorarchitecturen ondersteunt de driver?

Driver 18 ondersteunt deze besturingssystemen en processorarchitecturen:

besturingssysteem x64-ondersteuning Arm64-ondersteuning
Alpine Linux Yes Vanaf Driver 18.3
Azure Linux Yes Vanaf Driver 18.6.1
Debian Yes Vanaf Driver 18.1
Oracle Linux Yes No
Red Hat Enterprise Linux Yes Vanaf Driver 18.1
SUSE Linux Enterprise Server Yes No
Ubuntu Yes Te beginnen met Driver 18.1
macOS Yes Vanaf Driver 17.8

De ondersteunde versies van besturingssystemen veranderen bij elke driverrelease. Voor de tabel versie per versie, zie Systeemvereisten.

Welke SQL Server-functies ondersteunt de Linux- en macOS-driver?

De driver op Linux en macOS ondersteunt de meeste SQL Server-functies. Het ondersteunt geen gedistribueerde transactie-inschrijving via de SQL_ATTR_ENLIST_IN_DTC attributen, databasespiegeling, FILESTREAM of de driver-prestatieprofileringsattributen. LocalDB is niet beschikbaar op Linux of macOS. XA-transacties via de Distributed Transaction Coordinator (DTC) worden ondersteund vanaf Driver 17.3. Voor meer informatie, zie Gebruik XA-transacties met DTC. Voor de volledige lijst, zie Beperkingen.

Is de driver open source?

No. De Microsoft ODBC-driver voor SQL Server is niet open source.

Installeren en configureren

Welke driver manager gebruikt de driver?

De driver gebruikt de unixODBC driver manager. Wanneer je Driver 17 of 18 installeert met de pakketbeheerder van je platform of Homebrew, wordt unixODBC als afhankelijkheid geïnstalleerd. Volg de stappen voor Linux of macOS.

Op macOS bouw en draai je je applicatie met unixODBC in plaats van iODBC. Match de processorarchitectuur van de applicatie, driver manager en driver aan. Een fout zoals incompatible architecture (have 'arm64', need 'x86_64') duidt op een architectuurmismatch, niet per se op de verkeerde drivermanager.

Hoe controleer ik welke drivers geïnstalleerd zijn en welke configuratiebestanden in gebruik zijn?

Voer odbcinst -q -d uit om de geregistreerde stuurprogramma's weer te geven. De output toont elke drivernaam precies zoals een verbindingsreeks deze moet spellen:

[ODBC Driver 18 for SQL Server]

Voer odbcinst -j uit om de unixODBC-versie en de paden van odbcinst.ini te tonen, dat drivers registreert, en odbc.ini, dat systeem- en gebruikers-DSN's bevat:

unixODBC 2.3.11
DRIVERS............: /etc/odbcinst.ini
SYSTEM DATA SOURCES: /etc/odbc.ini
FILE DATA SOURCES..: /etc/ODBCDataSources
USER DATA SOURCES..: /home/<user>/.odbc.ini

Om een DSN te configureren, zie Connection strings and DSNs.

Waarom meldt de driver manager dat hij de driverbibliotheek niet kan openen?

De fout ziet er als volgt uit:

[01000][unixODBC][Driver Manager]Can't open lib 'ODBC Driver 18 for SQL Server' : file not found

Controleer deze oorzaken in volgorde:

  1. De Driver waarde in de verbindingsreeks of DSN komt niet overeen met de naam van een geregistreerde driver. Voer odbcinst -q -d uit en kopieer de naam exact.
  2. Je applicatie gebruikt andere configuratiebestanden dan de bestanden die je hebt bewerkt. Voer odbcinst -j uit in dezelfde omgeving als de applicatie en controleer welke drivermanager de applicatie laadt. Op macOS maakt u configuratie-symbolische links alleen aan als de applicatie ze nodig heeft, zoals beschreven in Probleemoplossing op macOS.
  3. Er is meer dan één kopie van de unixODBC-drivermanager geïnstalleerd, en je applicatie laadt de verkeerde. Voer op Linux de opdracht uit find /usr -name 'libodbc*.so*'. Op macOS voer find /opt/homebrew /usr/local -name 'libodbc*.dylib' uit. Meerdere paden alleen bewijzen niet dat meerdere drivermanagers zijn geïnstalleerd: Homebrew-links kunnen naar dezelfde bibliotheek in de Cellar-directory verwijzen. Controleer welke bibliotheek de applicatie daadwerkelijk laadt. Zie Problemen met verbindingen oplossen voor meer informatie.

Verbinding maken en verifiëren

Waarom faalt een verbinding die werkt met Driver 17 door een certificaatfout op Driver 18?

Driver 18 staat standaard op Encrypt=yes. Driver 17 is standaard alleen Encrypt=no als er geen niet-lege Authentication-instelling of toegangstoken wordt opgegeven. Een niet-lege Authentication instelling, inclusief Authentication=SqlPassword, of een toegangstoken verandert de standaard Driver 17 naar Encrypt=yes. Expliciete encryptie-instellingen overschrijven deze standaardinstellingen.

Controleer de effectieve instellingen in je verbindingsreeks, DSN en preconnection-attributen die via SQLSetConnectAttr zijn ingesteld. Bijvoorbeeld, Encrypt=yes in een DSN of SQL_COPT_SS_ENCRYPT=SQL_EN_ON vraagt om versleuteling zelfs wanneer de verbindingsreeks Encrypt weglaat. Geef toegangstokens alleen via het SQL_COPT_SS_ACCESS_TOKEN verbindingsattribuut, niet via een verbindingsstring-sleutelwoord.

Met Encrypt=yes en TrustServerCertificate=noversleutelen beide drivers de verbinding en valideren ze het servercertificaat. Met Encrypt=novalideert Driver 17 het certificaat niet, terwijl Driver 18 het valideert als de server encryptie afdwingt en TrustServerCertificate=no. Een verbinding die eerder de Driver 17-standaard Encrypt=no gebruikte, kan daarom falen met Driver 18 tegen een server met een zelfondertekend of anderszins onbetrouwbaar certificaat. Bij een zelfondertekend certificaat ziet de Driver 18-fout er als volgt uit:

[Microsoft][ODBC Driver 18 for SQL Server]SSL Provider: [error:0A000086:SSL routines::certificate verify failed:self-signed certificate]
[Microsoft][ODBC Driver 18 for SQL Server]Client unable to establish connection. For solutions related to encryption errors, see https://go.microsoft.com/fwlink/?linkid=2226722

Geef de voorkeur aan een vertrouwd certificaat of certificaatpinning. Gebruik deze opties:

  • Installeer een certificaat op de server dat is uitgegeven door een certificaatautoriteit die door de client wordt vertrouwd. Als het certificaat wordt vertrouwd maar de naam niet overeenkomt met de Server-waarde, zet HostNameInCertificate dan op de naam in het certificaat. HostNameInCertificate Verandert alleen de verwachte naam, dus het corrigeert geen zelfondertekend certificaat.
  • Met Driver 18.1 en latere versies en een server die Tabular Data Stream (TDS) 8.0 ondersteunt, stel Encrypt=strict in en stel ServerCertificate in op het pad naar een kopie van het certificaat van de server. De bestuurder accepteert dan alleen dat exacte certificaat. ServerCertificate werkt alleen in strikte modus.
  • Stel alleen in Encrypt=no als je onversleuteld applicatieverkeer accepteert wanneer de server geen encryptie forceert. Dit komt alleen overeen met de standaard van Driver 17 wanneer er geen niet-lege Authentication-instelling of toegangstoken is opgegeven en er geen encryptie-override is ingesteld. Als de server encryptie forceert, valideert Driver 18 het certificaat nog steeds, tenzij validatie via TrustServerCertificate=yes wordt uitgeschakeld.

Caution

TrustServerCertificate=yes schakelt encryptie niet in. Met Encrypt=yes, omzeilt het de certificaatvalidatie terwijl het verkeer versleuteld blijft, waardoor de verbinding openstaat voor man-in-the-middle-aanvallen. Met Encrypt=no, blijft applicatieverkeer onversleuteld tenzij de server encryptie forceert; als de server encryptie afdwingt, wordt certificaatvalidatie omzeild. Met TrustServerCertificate negeert de driver Encrypt=strict en valideert het certificaat, of vergelijkt het met ServerCertificate wanneer dit is geconfigureerd. Geef de voorkeur aan een vertrouwd certificaat of certificaatpinning.

Zie Standaardencryptiegedrag voor meer informatie.

Ondersteunt de driver Kerberos-authenticatie?

Ja. Vraag een Kerberos-ticket aan met kinit, en maak dan verbinding met Trusted_Connection=yes in de verbindingsreeks of DSN. De SQL Server-instantie heeft een geregistreerde service principal naam (SPN) nodig. Raadpleeg Geïntegreerde verificatie gebruiken voor de installatiestappen.

Ondersteunt de driver Microsoft Entra ID-authenticatie?

Ja, voor Azure SQL Database, Azure SQL Managed Instance en SQL Server 2022 en latere versies. Om SQL Server op te zetten, ook via Azure Arc, gebruik Microsoft Entra-authenticatie voor SQL Server. Op Linux en macOS ondersteunen Driver 17 en latere versies deze methoden:

  • Beheerde identiteit, met Authentication=ActiveDirectoryMsi, beginnend met Driver 17.3.
  • Service-principal, met Authentication=ActiveDirectoryServicePrincipal, beginnend met Driver 17.7.
  • Geïntegreerde authenticatie via Kerberos in een gefedereerde omgeving, met Authentication=ActiveDirectoryIntegrated, vanaf Driver 17.6.
  • Een toegangstoken dat je applicatie verkrijgt, doorgegeven via het SQL_COPT_SS_ACCESS_TOKEN-verbindingsattribuut.

ActiveDirectoryInteractiveis alleen beschikbaar in de Windows-driver. ActiveDirectoryPassword wordt verouderd. Driver-managed authenticatie op Linux en macOS ondersteunt geen scenario's die voorwaardelijke toegang vereisen. Als je applicatie een toegangstoken apart verkrijgt, regelen de authenticatiebibliotheek en het Microsoft Entra ID-beleid die tokenverwerving. Leid het token door SQL_COPT_SS_ACCESS_TOKEN.

Op Alpine Linux vereist geïntegreerde authenticatie een libcurl build met ondersteuning voor het Simple and Protected Generic Security Service Application Program Interface Negotiation Mechanism (SPNEGO). Controleer je geïnstalleerde libcurl mogelijkheden in plaats van aan te nemen dat het standaardpakket het ondersteunt.

Voor verbindingsstrings en codevoorbeelden, zie Gebruik Microsoft Entra ID met de ODBC-driver.

Ontwikkel en los problemen op

Kan een bestaande ODBC-applicatie de driver gebruiken op Linux of macOS?

Ja. Een applicatie die is geschreven voor de ODBC application programming interface (API) en gebouwd is tegen unixODBC kan deze driver laden. Om SQL Server-specifieke functies te gebruiken, neem je msodbcsql.h op na de unixODBC-headers. Voor compilercommando's en bibliotheeknamen, zie C- en C++-toepassingen ontwikkelen met het ODBC-stuurprogramma.

Is er een voorbeeldapplicatie?

Ja. Verbinding maken en query’s uitvoeren met C++ en ODBC bouwt en voert een voorbeeld uit op Linux, macOS en Windows.

Hoe traceer ik ODBC-aanroepen?

Trace-bestanden kunnen gevoelige gegevens bevatten. Gebruik het account dat je applicatie uitvoert en maak een map aan waar alleen dat account toegang toe heeft:

mkdir -m 700 "$HOME/odbc-trace"

Voeg deze instellingen toe aan het [ODBC] gedeelte van odbcinst.ini. Vervang /home/<user>/odbc-trace/odbctrace.log door het absolute pad binnen de map die je hebt aangemaakt. Op macOS gebruiken home-mappen meestal de notatie /Users/<user> in plaats van /home/<user>.

Houd het volledige trace-file pad op 62 bytes of minder om afkap door unixODBC te voorkomen.

[ODBC]
Trace = Yes
TraceFile = /home/<user>/odbc-trace/odbctrace.log

Deze instellingen schakelen tracering in voor applicaties die deze driver manager-configuratie gebruiken, en tracering vertraagt deze applicaties. Gebruik een aparte privémap voor elk applicatieaccount. Verwijder Trace = Yes het als je klaar bent, en verwijder tracebestanden die je niet meer nodig hebt. Voor per-applicatie tracering, zie Data access tracing op Linux en macOS.

Tekengegevens

Welke Unicode-codering moet een applicatie gebruiken?

Gebruik UTF-16LE (little endian) voor SQLWCHAR data. Gebruik UTF-16 SQLWCHAR buffers met de ODBC wide-character API's in plaats van het native wchar_t type, dat 32 bits is op Linux en macOS.

Gebruik UTF-8 voor SQLCHAR data. Vanaf Driver 17 accepteert de driver ook een set single-byte en double-byte codepagina's voor SQLCHAR data wanneer de proceslandinstelling er één selecteert. Processen starten in de C locale, dus de driver gebruikt UTF-8 tenzij de applicatie setlocale aanroept. Voor de lijst met coderingen, zie Tekengegevens verwerken.