系统要求、安装和驱动程序文件

项目
09/21/2023

本文讨论连接到 SQL Server 的 ODBC 驱动程序。

SQL 版本兼容性

兼容性表示在驱动程序发布时，已测试驱动程序与现有 SQL 版本的兼容性。 SQL Server 版本通常尝试保持与现有客户端驱动程序的后向兼容性。但是，旧的客户端驱动程序可能无法使用 SQL Server 版本中的新功能。

数据库版本 → ↓ 驱动程序版本	Azure SQL 数据库	Azure Synapse Analytics	Azure SQL 托管实例	SQL Server 2022	SQL Server 2019	SQL Server 2017	SQL Server 2016	SQL Server 2014	SQL Server 2012	SQL Server 2008 R2	SQL Server 2008	SQL Server 2005
18.3	是	是	是	是	是	是	是	是
18.2	是	是	是	是	是	是	是	是
18.1	是	是	是	是	是	是	是	是
18.0	是	是	是	是	是	是	是	是	是
17.1	是	是	是	是	是	是	是	是	是
17.9	是	是	是		是	是	是	是	是
17.8	是	是	是		是	是	是	是	是
17.7	是	是	是		是	是	是	是	是
17.6	是	是	是		是	是	是	是	是
17.5	是	是	是		是	是	是	是	是
17.4	是	是	是		是	是	是	是	是
17.3	是	是	是		是	是	是	是	是	是	是
17.2	是	是	是			是	是	是	是	是	是
17.1	是	是	是			是	是	是	是	是	是
17.0	是	是	是			是	是	是	是	是	是
13.1						是	是	是	是	是	是
13							是	是	是	是	是
11								是	是	是	是	是

连接字符串详细信息

在连接字符串中指定的驱动程序名称是以下值之一：

ODBC Driver 11 for SQL Server
ODBC Driver 13 for SQL Server（适用于 13 和 13.1）
ODBC Driver 17 for SQL Server
ODBC Driver 18 for SQL Server

支持的操作系统

下表显示了 Windows 操作系统版本的驱动程序版本支持：

操作系统 → ↓ 驱动程序版本	Windows Server 2022	Windows Server 2019	Windows Server 2016	Windows Server 2012 R2	Windows Server 2012	Windows Server 2008 R2	Windows 11	Windows 10	Windows 8.1	Windows 7	Windows Vista SP2
18.3	是	是	是	是			是	是
18.2	是	是	是	是			是	是
18.1	是	是	是	是	是		是	是	是
18.0	是	是	是	是	是		是	是	是
17.1	是	是	是	是	是		是	是	是
17.9	是	是	是	是	是		是	是	是
17.8		是	是	是	是			是	是
17.7		是	是	是	是			是	是
17.6		是	是	是	是			是	是
17.5		是	是	是	是			是	是
17.4		是	是	是	是	是		是	是	是
17.3		是	是	是	是	是		是	是	是
17.2			是	是	是	是		是	是	是
17.1			是	是	是	是		是	是	是
17.0			是	是	是	是		是	是	是
13.1			是	是	是	是		是	是	是
13					是	是			是	是
11					是	是				是	是

安装 Microsoft ODBC Driver for SQL Server

从任一 Windows 的下载运行 msodbcsql.msi 可以安装该驱动程序。

注意

对于安装了 Driver 17.1.0.1 或更低版本的用户，建议先手动将其卸载，然后再安装较新版本的驱动程序。

与 Native Client 并行安装

驱动程序可以与 SQL Server Native Client 并行安装。主要版本的驱动程序（11、13、17、18）也可以并行安装。

调用 msodbcsql.msi 时，默认仅安装客户端组件。客户端组件是一些文件，它们支持运行通过驱动程序开发的应用程序。要安装 SDK 组件，请在命令行中指定 ADDLOCAL=ALL。下面是一个示例。

msiexec /i msodbcsql.msi ADDLOCAL=ALL

最终用户许可证

如果使用 /passive、/qn、/qb 或 /qr 选项进行安装，请指定 IACCEPTMSODBCSQLLICENSETERMS=YES 以接受最终用户许可条款。必须以全大写字母指定此选项。下面是一个示例。

msiexec /quiet /passive /qn /i msodbcsql.msi IACCEPTMSODBCSQLLICENSETERMS=YES ADDLOCAL=ALL

无提示卸载

下面的示例演示如何执行无提示卸载。

msiexec /quiet /passive /qn /uninstall msodbcsql.msi

指示依赖关系

应用程序使用驱动程序时，该程序应指示它通过安装选项 APPGUID 依赖于驱动程序。在卸载前，此指示可使驱动程序安装程序报告依赖的应用程序。要在驱动程序上指定依赖项，请在无提示安装驱动程序时将 APPGUID 命令行参数设置为你的产品代码。当使用 Microsoft Installer 捆绑应用程序安装程序时，必须创建产品代码。下面是一个示例。

msiexec /i msodbcsql.msi APPGUID={ <Your dependent application's APPGUID> }

命令行工具：sqlcmd.exe 和 bcp.exe

用于驱动程序的 bcp.exe 和 sqlcmd.exe 工具可在适用于 SQL Server 的 Microsoft 命令行实用程序 11、适用于 SQL Server 的 Microsoft 命令行实用程序 13 或适用于 SQL Server 的 Microsoft 命令行实用程序 13.1 上下载。驱动程序是安装 sqlcmd.exe 和 bcp.exe 的必备组件。

bcp.exe 和 sqlcmd.exe 安装在 %PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC 的 110\Tools 子文件夹中（对于版本 11），以及 130\Tools 中（对于版本 13 和 13.1）。

对于使用 BCP 函数的应用程序，它指定的驱动程序必须来自与编辑应用程序所用的头文件和库一并传输的相同版本。

例如，当你使用 msodbcsql11.lib 和 msodbcsql.h 编译 ODBC 应用程序时，请在连接字符串中使用 DRIVER={ODBC Driver 11 for SQL Server}。

Windows 上的 Microsoft ODBC Driver for SQL Server 的组件

Windows 上的 ODBC 驱动程序包含以下组件：

组件	说明
`msodbcsql18.dll` 或 `msodbcsql17.dll` 或 `msodbcsql13.dll` 或 `msodbcsql11.dll`	包含所有驱动程序功能的动态链接库 (DLL) 文件。此文件安装在 `%SYSTEMROOT%\System32` 中。
`msodbcdiag18.dll` 或 `msodbcdiag17.dll` 或 `msodbcdiag13.dll` 或 `msodbcdiag11.dll`	包含驱动程序的诊断（跟踪）接口的动态链接库 (DLL) 文件。此文件安装在 `%SYSTEMROOT%\System32` 中。
`msodbcsqlr18.rll` 或 `msodbcsqlr17.rll` 或 `msodbcsqlr13.rll` 或 `msodbcsqlr11.rll`	驱动程序库的附带资源文件。此文件安装在 `%SYSTEMROOT%\System32\1033` 中。
`s13ch_msodbcsql.chm` 或 `s11ch_msodbcsql.chm`	数据源向导帮助文件，它记录如何为驱动程序创建数据源。此文件安装在 `%SYSTEMROOT%\System32\1033` 中注意：ODBC Driver 17 及更高版本没有 chm 文件。
`msodbcsql.h`	头文件，它包含使用驱动程序所需的所有新定义。注意：无法在同一个程序中引用 `msodbcsql.h` 和 `odbcss.h`。 ODBC Driver 18 的 `msodbcsql.h` 安装在 `%PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\180\SDK` 中。 ODBC Driver 17 的 `msodbcsql.h` 安装在 `%PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\170\SDK` 中。 ODBC Driver 13 的 `msodbcsql.h` 安装在 `%PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\130\SDK` 中。 ODBC Driver 11 的 `msodbcsql.h` 安装在 `%PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\110\SDK`。
`msodbcsql18.lib` 或 `msodbcsql17.lib` 或 `msodbcsql13.lib` 或 `msodbcsql11.lib`	库文件，调用属于驱动程序的 bcp 实用工具函数时需使用此文件。注意：如果确实在程序中引用此库文件，请确保它在你的系统路径中，并且在使用该应用程序的用户的系统路径中。 `msodbcsql18.lib` 安装在 `%PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\180\SDK` 中。 `msodbcsql17.lib` 安装在 `%PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\170\SDK` 中。 `msodbcsql13.lib` 安装在 `%PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\130\SDK` 中。 `msodbcsql11.lib` 安装在 `%PROGRAMFILES%\Microsoft SQL Server\Client SDK\ODBC\110\SDK` 中。

另请参阅

Windows 上的 Microsoft ODBC Driver for SQL Server