ODBC 驱动程序安装检查

总结

本文介绍如何确认在Windows计算机上正确安装、注册和配置了 Open Database Connectivity (ODBC) 驱动程序。 当应用程序无法连接到数据库、ODBC 驱动程序未出现在 ODBC 数据源管理员或收到错误 Data source name not found and no default driver specified (SQLSTATE IM002)时,请使用它。 验证步骤涵盖 ODBC 数据源管理员的 32 位和 64 位副本、Windows注册表中的数据源名称(DSN)和驱动程序条目,以及应用程序传递给 ODBC 驱动程序管理器的连接字符串。

您应该打开 ODBC 数据源管理员的哪个版本?

在 64 位版本的 Windows 上,存在两个 ODBC 数据源管理员 版本,并且每个版本分别管理与其位数对应的驱动程序和系统 DSN:

  • 对于 64 位应用程序,请选择 Windows+R 并键入 ODBCAD32.EXE 或 C:\WINDOWS\SYSTEM32\ODBCAD32.EXE。

  • 对于 32 位应用程序,请选择 Windows+R,然后键入 C:\WINDOWS\SYSWOW64\ODBCAD32.EXE。

这两个可执行文件都命名 为odbcad32.exe,因此文件夹路径确定打开的可执行文件。 始终将工具与建立连接的应用程序的位性匹配。 32 位应用程序无法加载 64 位 ODBC 驱动程序,64 位应用程序无法加载 32 位 ODBC 驱动程序。

ODBC 连接字符串示例

调用 ODBC 驱动程序的应用程序可以使用数据源名称(DSN)或无 DSN 连接字符串。 示例如下:

  • driver={ODBC Driver 18 for SQL Server};server=sqlprod01;database=AdventureWorks;trusted_connection=yes
  • dsn=userdsn1
  • dsn=test;uid=<user name>;pwd=<password>

第一个连接字符串显式指定驱动程序名称、服务器名称、数据库名称以及是否使用集成安全性(trusted_connection)。 这是一个无 DSN 的连接。

第二个和第三个连接字符串使用 DSN,它是对存储在注册表中的这些项目的封装。 用户名和密码不能存储在 DSN 中,必须显式指定。 有关 DSN 属性的详细信息,请参阅 DSN 连接字符串属性。

DSN 是一种供应用程序加载驱动程序的简便方式,提供了一层间接性。 通过使用 DSN,可以更改应用程序连接到的服务器、数据库,甚至数据库类型,而无需更改应用程序。

连接字符串中的驱动程序名称必须与计算机上注册的驱动程序的名称匹配。 驱动程序和 DSN 名称不区分大小写,但拼写和标点符号必须完全匹配。 如果没有注册的驱动程序匹配,ODBC 驱动程序管理器无法加载驱动程序。

注意

Windows 随附的 SQL Server 驱动程序(sqlsrv32.dll)和 SQL Server Native Client 驱动程序(SQL Server Native Client 11.0)都不建议用于新的开发。 SQL Server Native Client 未随 SQL Server 2022(16.x)及更高版本或SQL Server Management Studio 19 及更高版本一起提供。 对于新建连接,请使用 Microsoft ODBC Driver for SQL Server,可下载适用于 Windows、Linux 和 macOS 的版本。

验证驱动程序和 DSN 是否显示在 ODBC 数据源管理员中

使用 ODBC 数据源管理员验证 ODBC 驱动程序和 DSN 是否存在。 打开与应用程序位数匹配的版本,然后检查Drivers选项卡,查看是否列出了该驱动程序。 以下屏幕截图显示了 64 位和 32 位驱动程序:

屏幕截图显示了 64 位驱动程序。

屏幕截图显示了 32 位驱动程序。

如果列出了驱动程序,请在 “系统 DSN ”或“ 用户 DSN ”选项卡上创建一个测试 DSN 并运行连接测试。 成功的测试确认驱动程序加载并可访问服务器。 如果未列出驱动程序,请重新安装驱动程序,然后按照下一部分所述检查注册表项。

注册表中的 ODBC 驱动程序和 DSN 信息

驱动程序和 DSN 信息存储在注册表中:

屏幕截图显示了注册表中的驱动程序和 DSN 信息。

在 64 位计算机上,注册表重定向将驱动程序和系统 DSN 的 32 位和 64 位信息分开。 Wow6432Node注册表项存储 32 位驱动程序和系统 DSN 信息。 不会重定向用户 DSN,因此 32 位和 64 位工具都显示所有用户 DSN。 相关密钥包括:

  • HKEY_LOCAL_MACHINE\SOFTWARE\ODBC (64 位驱动程序和系统 DSN)
  • HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\ODBC (32 位驱动程序和系统 DSN)
  • HKEY_CURRENT_USER\Software\ODBC (当前用户的用户 DSN)

ODBC.INI 子项包含所有 DSN 的列表以及每个 DSN 的子项。 ODBCINST.INI 子项键列出所有驱动程序。

屏幕截图显示了 ODBC。INI 和 ODBCINST。INI 子项。

如果通过 DSN 加载驱动程序时遇到问题,请检查 ODBC.INI 子项以找出 DSN 正在使用的驱动程序。

屏幕截图显示如何找出 DSN 正在使用的驱动程序。

此外,还确认下面 ODBCINST.INI 列出的驱动程序路径指向磁盘上存在的 DLL 文件。 引用缺失或移动 DLL 的注册表项是卸载、升级或手动文件清理后加载失败的常见原因。 有关用于SQL Server安装的 Microsoft ODBC 驱动程序的文件名和位置,请参阅系统要求、安装和驱动程序文件。

注意

LastUser 条目不会影响连接字符串。 仅当在 ODBC 数据源管理员中测试 DSN 时,才使用它。

排查错误 IM002:找不到数据源名称且未指定默认驱动程序

验证服务器名称、数据库名称以及是否安装了驱动程序。 如果无法加载驱动程序,将收到以下错误消息:

错误 [IM002] [Microsoft][ODBC 驱动程序管理器] 未找到数据源名称,未指定默认驱动程序。

此错误表示 ODBC 驱动程序管理器无法解析连接字符串中的 DSN 或驱动程序名称。 按顺序检查以下项:

  1. 连接字符串中的 DSN 名称与 ODBC 数据源管理员中列出的 DSN 匹配。
  2. 已安装位数匹配的驱动程序。 用户 DSN 会同时出现在 32 位和 64 位工具中,但如果它所指向的驱动程序没有安装适用于该应用程序位数的版本,连接就会失败。 有关详细信息,请参阅 ODBC 管理员工具同时显示 32 位和 64 位用户 DSN。
  3. 系统 DSN 是在与应用程序位数相匹配的工具中创建的。 系统 DSN 是注册表重定向的,因此在 64 位工具中创建的系统 DSN 不适用于 32 位应用程序。
  4. DSN 范围与运行应用程序的帐户匹配。 位于 HKEY_CURRENT_USER 下的用户 DSN 对在其他账户下运行的服务不可见。 将系统 DSN 用于服务和 Web 应用程序。
  5. 无 DSN 连接字符串中的驱动程序名称与 ODBCINST.INI 子项下列出的驱动程序相匹配。

即使 DSN 中的驱动程序路径不正确,驱动程序管理器仍可根据 ODBC Data Sources 注册表键中列出的驱动程序名称,在对应的 ODBCINST.INI 子项中定位到该驱动程序。

如果驱动程序加载但连接仍然失败,则问题通常是与网络、身份验证或加密相关的,而不是安装问题。 有关这些症状,请参阅排查SQL Server中的连接问题。

支持非Microsoft ODBC 驱动程序

对于非Microsoft ODBC 驱动程序,Microsoft支持仅限于以下操作:

  • 检查驱动程序注册表项是否存在。 如果不是,请重新安装驱动程序或咨询供应商。
  • 检查路径是否指向存在的 DLL 文件。 如果没有,请重新安装驱动程序或咨询供应商。
  • 创建测试 DSN 并执行连接测试。
  • 帮助捕获一份进程监视器(Procmon)跟踪记录,以便供应商进行分析。

驱动程序行为、驱动程序缺陷和驱动程序安装逻辑仍然是生成驱动程序的供应商的责任。

第三方信息免责声明

本文讨论的第三方产品由独立于微软的公司制造。 Microsoft 对这些产品的性能和可靠性不作任何明示或默示担保。