Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Denna artikel beskriver Microsoft ODBC-drivrutinen för SQL Server och dess kompatibilitet med Microsoft SQL-produkter.
Microsoft SQL-versionskompatibilitet
Kompatibilitet indikerar att du kan använda en drivrutin med den listade databasversionen. SQL Server-versioner behåller generellt bakåtkompatibilitet med befintliga klientdrivrutiner, men äldre drivrutiner kanske inte exponerar funktioner som introducerats i senare databasversioner.
| Databasversion → ↓ Drivrutinsversion |
SQL-databas i Microsoft Fabric | Azure SQL Database | Azure Synapse Analytics | Hanterad instans i Azure SQL | SQL Server 2025 | SQL Server 2022 | SQL Server 2019 | SQL Server 2017 |
|---|---|---|---|---|---|---|---|---|
| 18.7 | Ja | Ja | Ja | Ja | Ja | Ja | Ja | Ja |
| 18.6 | Ja | Ja | Ja | Ja | Ja | Ja | Ja | Ja |
| 18,5 | Ja | Ja | Ja | Ja | Ja | Ja | Ja | Ja |
| 18.4 | Ja | Ja | Ja | Ja | Ja | Ja | Ja | Ja |
| 18.3 | Ja | Ja | Ja | Ja | Ja | Ja | Ja | |
| 18.2 | Ja | Ja | Ja | Ja | Ja | Ja | Ja | |
| 18.1 | Ja | Ja | Ja | Ja | Ja | Ja | Ja | |
| 18,0 | Ja | Ja | Ja | Ja | Ja | Ja | Ja | |
| 17.11 | Ja | Ja | Ja | Ja | Ja | Ja | Ja | Ja |
| 17.10 | Ja | Ja | Ja | Ja | Ja | Ja | Ja | Ja |
| 17,9 | Ja | Ja | Ja | Ja | Ja | |||
| 17.8 | Ja | Ja | Ja | Ja | Ja | |||
| 17.7 | Ja | Ja | Ja | Ja | Ja | |||
| 17.6 | Ja | Ja | Ja | Ja | Ja | |||
| 17,5 | Ja | Ja | Ja | Ja | Ja | |||
| 17.4 | Ja | Ja | Ja | Ja | Ja | |||
| 17,3 | Ja | Ja | Ja | Ja | Ja | |||
| 17.2 | Ja | Ja | Ja | Ja | ||||
| 17.1 | Ja | Ja | Ja | Ja | ||||
| 17.0 | Ja | Ja | Ja | Ja | ||||
| 13.1 | Ja | |||||||
| tretton | ||||||||
| 11 |
Information om anslutningssträng
Ange ett av följande drivrutinsnamn i en reťazec pripojenia:
- Använd
ODBC Driver 18 for SQL Serverför Driver 18. - Använd
ODBC Driver 17 for SQL Serverför Driver 17. - Använd
ODBC Driver 13 for SQL Serverför Driver 13 och 13.1. - Använd
ODBC Driver 11 for SQL Serverför Driver 11.
Operativsystem som stöds
Följande tabell visar vilka Windows-versioner varje drivrutinsversion stöder:
| Operativsystem → ↓ Drivrutinsversion |
Windows Server 2025 | Windows Server 2022 | Windows Server 2019 | Windows Server 2016 | Windows 11 |
|---|---|---|---|---|---|
| 18.7 | Ja | Ja | Ja | Ja | Ja |
| 18.6 | Ja | Ja | Ja | Ja | Ja |
| 18,5 | Ja | Ja | Ja | Ja | Ja |
| 18.4 | Ja | Ja | Ja | Ja | |
| 18.3 | Ja | Ja | Ja | Ja | |
| 18.2 | Ja | Ja | Ja | Ja | |
| 18.1 | Ja | Ja | Ja | Ja | |
| 18,0 | Ja | Ja | Ja | Ja | |
| 17.10 | Ja | Ja | Ja | Ja | Ja |
| 17,9 | Ja | Ja | Ja | Ja | |
| 17.8 | Ja | Ja | |||
| 17.7 | Ja | Ja | |||
| 17.6 | Ja | Ja | |||
| 17,5 | Ja | Ja | |||
| 17.4 | Ja | Ja | |||
| 17,3 | Ja | Ja | |||
| 17.2 | Ja | ||||
| 17.1 | Ja | ||||
| 17.0 | Ja | ||||
| 13.1 | Ja | ||||
| tretton | |||||
| 11 |
Installera Microsoft ODBC-drivrutinen för SQL Server
Använd Driver 18 för nya applikationer. Driver 17 fortsätter att stödjas för applikationer som kräver version 17-beteende. Innan du uppgraderar en applikation från Driver 17 till Driver 18, gå igenom de största versionsskillnaderna, inklusive ändringen av krypteringsstandardinställningar. För datum för support, se supportlivscykeln.
Båda huvudversionerna använder en installationsprogram som heter msodbcsql.msi. Välj installationsprogrammet Driver 18 eller Driver 17 från Nedladdningar för Windows. Det installerade drivrutinsnamnet och mjukvaruutvecklingskitets (SDK)-filer förblir specifika för huvudversionen.
- Välj installationsprogrammet för arkitekturen för ditt Windows-operativsystem: x64, x86 eller ARM64, beroende på vad som finns tillgängligt för den valda versionen. Använd x64-installationsprogrammet på x64 Windows, även för 32-bitarsapplikationer; använd inte x86-installationsprogrammet på 64-bitars Windows.
- Ladda ner installationsprogrammet till en separat katalog för den valda huvudversionen. Drivrutin 17:s och Drivrutin 18:s installationsprogram har samma filnamn.
- Kör installationsprogrammet med administratörsbehörighet, granska licensvillkoren och slutför installationen. För obevakade installationer eller SDK-komponenter, använd alternativen i följande avsnitt.
- Upprepa: Verifiera installationen och kontrollera registrering och filversion för den huvudversion du installerade.
För att uppdatera en installerad drivrutin, ladda ner och kör installationsprogrammet för samma huvudversion. För att gå från Driver 17 till Driver 18, installera Driver 18 och uppdatera din applikation så att den begär ODBC Driver 18 for SQL Server.
På Windows ARM64, ta bort eventuell x64 Driver 18-installation via Remove eller reinstall Driver 17 eller Driver 18 innan du kör ARM64-installationsprogrammet. ARM64-installationsprogrammet för Driver 18.7.1.1 rapporterar en arkitekturkonflikt och stoppar endast för x64 Driver 18-versioner till och med 18.5.1.1. Den upptäcker inte senare x64-versioner, så båda produkterna förblir installerade. Efter att du tagit bort x64-installationen, kör ARM64-installationsprogrammet och verifiera installationen.
Anmärkning
Användare med drivrutinsversion 17.1.0.1 eller tidigare rekommenderas att avinstallera den befintliga drivrutinen manuellt innan du fortsätter med installationen av den uppdaterade versionen.
Kontrollera installationen
Kör följande kommandon i PowerShell för att kontrollera Windows-processorarkitekturen, registrerade drivrutinsnamn, ODBC-plattformar, drivrutinsvägar och filversioner:
$ErrorActionPreference = 'Stop'
Get-CimInstance -ClassName Win32_ComputerSystem |
Select-Object -ExpandProperty SystemType
$driverNames = @(
'ODBC Driver 17 for SQL Server',
'ODBC Driver 18 for SQL Server'
)
$drivers = @(
Get-OdbcDriver -Platform All |
Where-Object { $_.Name -in $driverNames }
)
if ($drivers.Count -eq 0) {
throw 'Neither ODBC Driver 17 nor ODBC Driver 18 for SQL Server is registered.'
}
foreach ($driver in $drivers) {
$driverPath = $driver.Attribute['Driver']
[pscustomobject]@{
Name = $driver.Name
Platform = $driver.Platform
DriverPath = $driverPath
FileVersion = (Get-Item -LiteralPath $driverPath).VersionInfo.FileVersion
}
}
SystemType visar processorarkitekturen i Windows. Egenskapen Platform visar om en drivrutin är registrerad för 32-bitars eller 64-bitars applikationer. Inget av dessa värden fastställer din applikations målarkitektur eller om dess drivrutinsbinär körs nativt eller under emulering. Filversionen varierar beroende på installerad version. blocket misslyckas om ingen av huvudversionerna registreras; en installation med endast en huvudversion är giltig. Kontrollera att resultaten inkluderar den huvudversion du installerade, kör sedan förfrågan igen efter en uppdatering.
Ta bort eller installera om Driver 17 eller Driver 18
Stäng applikationer som använder drivrutinen innan du tar bort den. På Windows med skrivbordsgränssnitt, öppna ovládací panel>Programs>Programs and Features. Välj Microsoft ODBC Driver 17 för SQL Server eller Microsoft ODBC Driver 18 för SQL Server och välj sedan Avinstallera. På Windows Server Core, använd Silent Uninstall med motsvarande installationsprogram. Du behöver administratörsbehörighet.
Efter borttagning kör du följande registerfråga. Byt ut 18 med 17 för att kontrollera Driver 17:
Get-OdbcDriver -Platform All |
Where-Object { $_.Name -eq 'ODBC Driver 18 for SQL Server' }
Sökningen bör inte returnera några matchande registreringar. För att installera om drivrutinen, kör det matchande installationsprogrammet för huvudversionen från Nedladdningar för Windows och upprepa sedan Verifiera installationen. Att ta bort en drivrutin kan förhindra att applikationer som begär dess drivrutinsnamn ansluter. Radera inte drivrutinsfiler manuellt.
C-körtidskompatibilitet
Drivrutin 18.6 och tidigare versioner, inklusive alla Driver 17-versioner, kräver Visual C++ v14 Redistributable på Windows. Från och med Driver 18.7 inkluderar drivrutinsinstallatören runtime. När du installerar Redistributable separat, använd den senaste stödda versionen från Microsoft Visual C++ Redistributable latest supported downloads. Den senaste stödda versionen uppfyller alla minimikrav i följande tabell.
| Drivrutinsversion | Architecture | Separat Visual C++-installation krävs | Minsta Visual C++-version |
|---|---|---|---|
| 18.7.1.1 | x86, x64, ARM64 | No. Installationsprogrammet inkluderar version 14.44.35211.0. | Ej tillämpbart |
| 17.11.1.1 | x86, x64 | Yes. Ladda ner x86 eller x64. | 14.15 |
| 18.6.2.1 | x86, x64, ARM64 | Yes. Ladda ner x86, x64 eller ARM64. | 14.34 |
Minimikravet är huvud- och delversionen. Det följer Visual C++ Redistributable-kompatibilitetsregeln, som kräver att Redistributables huvudversion matchar verktygsuppsättningen och dess mindre version är densamma eller högre. För mer information, se Windows-förutsättningarna.
Important
Ett program som körs nativt och använder lokal distribution för en äldre körningsmiljö för Microsoft Visual C++ kan tvinga en nyare ODBC-drivrutin att läsa in den körningsmiljön i stället för den version som drivrutinen kräver. Till exempel kan detta problem uppstå när en applikation byggd med Visual Studio 2019 (v142) plattformsverktygsuppsättningen inkluderar en äldre runtime i applikationskatalogen. Versionsavvikelsen kan orsaka fel när applikationen laddar in eller använder ODBC-drivrutinen.
Använd inte lokal distribution för Visual C++-runtime. Om din applikation kräver lokal distribution, se till att dess körtid är minst lika ny som de senaste byggverktygen som används för att bygga någon applikationskomponent, inklusive ODBC-drivrutinen. För mer information, se C++ binärkompatibilitet mellan Visual Studio-versioner: Begränsningar.
Sida vid sida med Native Client
Drivrutinen kan installeras sida vid sida med den interna SQL Server-klienten. Huvudversioner av drivrutinen (11, 13, 17, 18) kan också installeras sida vid sida med varandra.
Från och med drivrutin 17.11.1.1 och drivrutin 18.5.1.1 installerar Windows-installationsprogrammet både Core- och SDK-funktioner som standard. Tidigare versioner av Driver 17 och Driver 18 installerar endast Core som standard. För att installera alla funktioner i en tidigare version, ange ADDLOCAL=ALL på kommandoraden. Här är ett exempel.
msiexec /i msodbcsql.msi ADDLOCAL=ALL
Slutanvändarlicens
För att acceptera slutanvändarlicensvillkoren när du installerar med /quiet, /passive, /qn, /qb, eller /qr, specificera IACCEPTMSODBCSQLLICENSETERMS=YES. Skriv egenskapen med versaler. Här är ett exempel.
msiexec /quiet /i msodbcsql.msi IACCEPTMSODBCSQLLICENSETERMS=YES ADDLOCAL=ALL
Tyst avinstallation
I följande exempel visas hur du utför en tyst avinstallation.
msiexec /quiet /uninstall msodbcsql.msi
En tyst avinstallation kan returnera avslutningskoden 0 utan att ta bort drivrutinen. Till exempel förblir drivrutinen installerad när ett installerat program har registrerat ett beroende av den. Efter en tyst avinstallation, kör registreringsfrågan i Ta bort eller installera om Driver 17 eller Driver 18 för att bekräfta att drivrutinen togs bort.
Ange beroende
När du paketerar ett applikationsinstallationsprogram med Microsoft Installer, tilldela det en produktkod. När du tyst installerar ODBC-drivrutinen, ställ in APPGUID på den produktkoden. Medan produkten med den koden är installerad stoppar drivrutinsinstallatören eventuell avinstallation av drivrutinen. Här är ett exempel.
msiexec /quiet /i msodbcsql.msi IACCEPTMSODBCSQLLICENSETERMS=YES APPGUID={<product-code-guid>}
Byt ut <product-code-guid> med den produktkod GUID som tilldelats din applikation. Omge inte egenskapen APPGUID= med citattecken. När hela egenskapen är citerad msiexec behandlas den som ett ogiltigt argument och visar sitt användningsmeddelande istället för att installera drivrutinen.
Kommandoradsverktyg: sqlcmd.exe och bcp.exe
Det nuvarande Microsoft Command Line Utilities-paketet innehåller bcp.exe och det ODBC-baserade sqlcmd.exe. Paketet är separat från ODBC-drivrutinen och kräver den senaste Microsoft ODBC-drivrutinen för SQL Server. Ladda ner paketet för Windows x64 eller Windows x86.
Tidigare paket finns tillgängliga från Microsoft Command Line Utilities 11, Microsoft Command Line Utilities 13 och Microsoft Command Line Utilities 13.1. De äldre verktygen i version 11 installeras i undermappen 110\Tools till %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC; versionerna 13 och 13.1 använder undermappen 130\Tools.
En applikation som använder BCP-funktioner måste använda den drivrutinsversion som matchar huvudet och biblioteket som användes för att kompilera det.
Kompilera till exempel med Driver 18 msodbcsql.h och msodbcsql18.lib, använd DRIVER={ODBC Driver 18 for SQL Server} sedan i reťazec pripojenia. För Driver 17, använd msodbcsql17.lib och DRIVER={ODBC Driver 17 for SQL Server}.
Nyckelkomponenter i Microsoft ODBC-drivrutinen för SQL Server på Windows
Windows-installationsprogrammet innehåller följande nyckelkomponenter:
| Komponent | Beskrivning |
|---|---|
msodbcsql18.dll ellermsodbcsql17.dll ellermsodbcsql13.dll ellermsodbcsql11.dll |
Huvuddriverns dynamiska länkbibliotek (DLL). Windows installerar filen i systemkatalogen för dess arkitektur. |
msodbcdiag18.dll ellermsodbcdiag17.dll ellermsodbcdiag13.dll ellermsodbcdiag11.dll |
DLL-filen (Dynamic Link Library) som innehåller drivrutinsgränssnittet för diagnostik (spårning). Windows installerar filen i systemkatalogen för dess arkitektur. |
msodbcsqlr18.rll ellermsodbcsqlr17.rll ellermsodbcsqlr13.rll ellermsodbcsqlr11.rll |
Den tillhörande resursfilen för drivrutinsbiblioteket. Windows installerar filen i underkatalogen 1033 i systemkatalogen för dess arkitektur. |
s13ch_msodbcsql.chm ellers11ch_msodbcsql.chm |
Hjälpfilen för guiden Datakälla dokumenterar hur du skapar en datakälla för drivrutinen. Windows installerar filen i underkatalogen 1033 i systemkatalogen för systemets arkitektur.OBS: Det finns ingen chm-fil för ODBC Driver 17 och senare versioner. |
msodbcsql.h |
Rubrikfilen som innehåller alla nya definitioner som behövs för att använda drivrutinen. Obs: Du kan inte referera till både msodbcsql.h och odbcss.h i samma program.msodbcsql.h för ODBC Driver 18 är installerad i %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\180\SDK\Include.msodbcsql.h för ODBC Driver 17 är installerad i %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\170\SDK\Include.msodbcsql.h för ODBC Driver 13 är installerad i %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\130\SDK.msodbcsql.h för ODBC Driver 11 är installerad i %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\110\SDK. |
msodbcsql18.lib ellermsodbcsql17.lib ellermsodbcsql13.lib ellermsodbcsql11.lib |
Biblioteksfilen som behövs för att anropa de bcp--verktygsfunktioner som är en del av drivrutinen.msodbcsql18.lib installeras under %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\180\SDK\Lib.msodbcsql17.lib installeras under %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\170\SDK\Lib.För Driver 17 och Driver 18, välj x86-, x64- eller arm64-underkatalogen för applikationsmålet, som finns tillgänglig i det valda installationsprogrammet, och lägg till den i ditt projekts söksökväg för länkbiblioteket.msodbcsql13.lib installeras i %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\130\SDK.msodbcsql11.lib installeras i %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\110\SDK. |