OLE DB 驱动程序安装检查

总结

本文介绍如何检查Windows计算机上安装了SQL Server的对象链接和嵌入数据库(OLE DB)驱动程序或提供程序、如何验证其工作原理以及如何跟踪Windows注册表中的注册。 当应用程序无法连接到SQL Server并且你怀疑 OLE DB 驱动程序丢失或未注册时,请使用这些检查。

通过 PowerShell 验证 OLE DB 驱动程序或提供程序

若要查找操作系统上安装 SQL Server 的 OLE DB 驱动程序版本,请以管理员身份运行以下 PowerShell cmdlet。

Get-ChildItem -Path "HKLM:\SOFTWARE\Microsoft", "HKLM:\SOFTWARE\Wow6432Node\Microsoft" |
    Where-Object { $_.Name -like "*MSOLEDBSQL*" } |
    ForEach-Object { Get-ItemProperty $_.PSPath }

如果在操作系统上安装版本 18 和 19,输出可能如下所示。

InstalledVersion : 18.7.4.0
PSPath           : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSOLEDBSQL
PSParentPath     : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft
PSChildName      : MSOLEDBSQL
PSProvider       : Microsoft.PowerShell.Core\Registry

InstalledVersion : 19.4.1.0
PSPath           : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSOLEDBSQL19
PSParentPath     : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft
PSChildName      : MSOLEDBSQL19
PSProvider       : Microsoft.PowerShell.Core\Registry

InstalledVersion : 18.7.4.0
PSPath           : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\MSOLEDBSQL
PSParentPath     : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft
PSChildName      : MSOLEDBSQL
PSProvider       : Microsoft.PowerShell.Core\Registry

InstalledVersion : 19.4.1.0
PSPath           : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\MSOLEDBSQL19
PSParentPath     : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft
PSChildName      : MSOLEDBSQL19
PSProvider       : Microsoft.PowerShell.Core\Registry

InstalledVersion 值显示每个已安装驱动程序的确切版本号。 用于 SQL Server 的 Microsoft OLE DB Driver 19(MSOLEDBSQL19)可与用于 SQL Server 的 Microsoft OLE DB Driver 18(MSOLEDBSQL)并行安装,因此看到这两个键是正常的。 若要确认是否正在运行最新版本,请将该值与下载Microsoft OLE DB Driver for SQL Server中列出的当前正式发布版本(GA)版本进行比较。

检查是否已安装 SQL Server Native Client(SQLNCLI)

若要检查 OLE DB 提供程序接口 (SQLNCLI) 安装,请以管理员身份运行以下 PowerShell cmdlet。

Get-ChildItem -Path "HKLM:\SOFTWARE\Microsoft", "HKLM:\SOFTWARE\Wow6432Node\Microsoft" |
   Where-Object { $_.Name -like "*SQLNCLi*" } |
   ForEach-Object {   Get-ItemProperty $_.PSPath}

注意

SQL Server Native Client(SNAC 或 SQLNCLISQLNCLI11)和旧版 Microsoft OLE DB Provider for SQL Server (SQLOLEDB) 未随 SQL Server 2022(16.x) 及更高版本一起提供,也不附带 SQL Server Management Studio 19 及更高版本。 不建议将其用于新的应用程序开发。 请改用Microsoft OLE DB Driver for SQL Server。 本文仍在示例中使用 SQLNCLI,因为在你排查故障时遇到的现有系统中,它仍然很常见。

通过 UDL 文件验证 OLE DB 驱动程序

测试 OLE DB 驱动程序的最简单方法是使用通用数据链接 (UDL) 文件。 UDL 文件将打开 “数据链接属性 ”对话框,其中列出了在计算机上注册的 OLE DB 访问接口,并允许你在不使用完整应用程序的情况下测试连接。

若要创建并打开 UDL 文件,请执行以下步骤:

  1. 确保文件资源管理器中 已启用文件扩展名 ,以便可以更改扩展名。
  2. 在文件资源管理器中创建任意一个文本文件,然后将其重命名为具有 .udl 文件扩展名的文件。 当Windows警告你更改文件扩展名时,请选择“是”。
  3. 双击该文件以打开 “数据链接属性 ”对话框,可在其中查看已安装的提供程序并测试其连接。 屏幕截图显示如何使用 UDL 文件测试 OLE DB 提供程序。
  4. 在对话框中选择 “确定” 以确认配置。

Tip

如果双击文件未打开 “数据链接属性 ”对话框(例如,该文件在文本编辑器中打开或返回错误),请尝试以下任一替代方法:

  • 右键单击 .udl 文件,然后选择“ 属性”。 在大多数系统上,此操作还会打开 “数据链接属性 ”对话框。

  • 通过运行以下命令直接打开对话框,其中 C:\temp\test.udl 是文件的路径:

    Rundll32.exe "C:\Program Files\Common Files\System\OLE DB\oledb32.dll",OpenDSLFile C:\temp\test.udl

若要在 64 位操作系统上打开 32 位对话框,请参阅 启动 UDL 文件。

有关针对每个提供程序测试连接的分步说明,请参阅使用 UDL 文件测试与 SQL Server 的 OLE DB 连接。

检查 UDL 文件内容以获取连接字符串

如果在文本编辑器中打开 UDL 文件,则可以复制连接字符串以在应用程序中使用。 这里是两个示例:

Provider=MSOLEDBSQL.1;Integrated Security=SSPI;Persist Security Info=False;User ID="";Initial Catalog=master;Data Source=localhost;Initial File Name="";Server SPN="";Authentication="";Access Token=""
Provider=SQLNCLI11.1;Integrated Security="";Persist Security Info=False;User ID=sa;Initial Catalog=AdventureWorks;Data Source=tcp:SQLProd01.contoso.com,1433;Initial File Name="";Server SPN=""

跟踪Windows注册表中的 OLE DB 提供程序

若要验证驱动程序,请首先检查名称是否显示在 64 位或 32 位 UDL 对话框中的已安装提供程序列表中,如上一部分所示。 如果没有,请重新安装提供商或联系供应商。

如果列出提供程序,但连接仍然失败,请跟踪注册表中的驱动程序位置。 驱动程序名称是 COM ProgID。 可以在 HKEY_CLASSES_ROOT中找到它。

将 ProgID 映射到提供程序名称

使用 SQL Server Native Client 驱动程序作为示例,下图显示了 ProgID SQLNCLI11.1 与提供程序名称SQL Server Native Client 11.0 之间的映射。

屏幕截图显示了 ProgID SQLNCLI11.1 与提供程序名称 SQL Server Native Client 11.0 之间的映射。

32 位和 64 位提供程序的 ProgID 显示在同一个密钥下。

除了 SQLNCLI11.1,还有一个名为 SQLNCLI11 的 ProgID。 原因是提供程序开发人员可能允许同一提供程序的多个版本并排安装,每个版本都有不同的数字后缀。 未编号的名称是与版本无关的 ProgID。 应用程序可以指向此目标,并重定向到最新版本的提供程序。

实际上,这两个不同的 ProgID 名称应视为等效。 但是,在某些情况下,它们可能不存在。 在这些情况下,使用与版本无关的名称的应用程序无法连接,但如果使用版本控制 ProgID,则可以连接。 原因是两个条目指向不同的 CLSID 值,即如何查找提供程序 DLL。

屏幕截图显示如何使用带版本号的 ProgId 查找提供程序的 DLL。

从 CLSID 中找到提供程序 DLL

CLSID 是 COM GUID。 COM 基础结构从 ProgID 中找到 GUID。 然后,它会在 HKEY_CLASSES_ROOT\CLSID 键项下查找其 GUID 与键名匹配的键:

屏幕截图显示如何在 HKEY_CLASSES_ROOT\CLSID 下查找 ProgId 中的 GUID。

该值 InProcServer32 指向提供程序 DLL。

对于 32 位提供程序,COM 使用相同的 GUID,但会在 HKEY_CLASSES_ROOT\Wow6432Node\CLSID 下查找它。

屏幕截图显示提供程序位于 SysWow64 文件夹中。

在这种情况下,提供程序位于 SysWow64 文件夹中。

注意

这些示例来自 64 位计算机。 在 32 位计算机上,注册表中没有 Wow6432Node 。

用于检查 SQL Server Native Client 11.0 的注册表路径

这些注册表项是 64 位计算机的注册表编辑器中SQL Server Native Client 11.0 的路径:

  • HKEY_CLASSES_ROOT\SQLNCLI11.1\CLSID
  • HKEY_CLASSES_ROOT\CLSID\<guid>\InProcServer32
  • HKEY_CLASSES_ROOT\Wow6432Node\CLSID\<guid>\InProcServer32

以下是 32 位计算机的注册表编辑器中的路径:

  • HKEY_CLASSES_ROOT\SQLNCLI11.1\CLSID
  • HKEY_CLASSES_ROOT\CLSID\{guid}\InProcServer32

对非 Microsoft OLE DB 提供程序的支持

对非 Microsoft OLE DB 提供程序的技术支持仅限于验证 ProgID 是否指向有效的 CLSID,以及 InProcServer32 子项是否指向正确的 DLL。 如果路径不正确或注册表项不存在,请重新安装提供程序或联系供应商。

使用 regsvr32 手动注册提供程序 DLL

如果文件存在但注册表项不存在,则可以使用 REGSVR32 手动注册提供程序。 若要注册 COM DLL,请在提升权限的命令提示符中运行以下命令:

Regsvr32 sqlncli11

屏幕截图显示了注册 COM DLL 的管理员命令。

如果有 32 位和 64 位版本的提供程序,请针对这两个 DLL 运行命令。 使用 32 位命令提示符注册 32 位 DLL。