Visual Studio 2022+ 中 SSIS 项目扩展的故障排除指南

适用于：SQL ServerAzure SQL 数据库Azure Synapse Analytics

请访问 SQL Server Integration Services （SSIS） 博客 ，直接从产品团队获取有关 SSIS 的最新信息、提示、新闻和公告。 扩展市场中列出了集成服务 (SSIS) 扩展发行说明。

组件下载

• 若要使用 Oracle 和 Teradata 连接器设计包，并在 SQL Server 2019（15.x）之前面向早期版本的 SQL Server，除了 Microsoft Oracle 连接器 和 Microsoft Teradata 连接器之外，还需要安装 Attunity 提供的相应版本的 Microsoft Connector for Oracle 和 Teradata。

  • 版本 5.0 Microsoft Connector for Oracle by Attunity 和 Microsoft Connector for Teradata by Attunity（定目标到 SQL Server 2017）
  • 版本 4.0 Microsoft Connector for Oracle by Attunity 和 Microsoft Connector for Teradata by Attunity（定目标到 SQL Server 2016）
  • 版本 3.0 Microsoft Connector for Oracle by Attunity 和 Microsoft Connector for Teradata by Attunity（定目标到 SQL Server 2014）
  • 版本 2.0 Microsoft Connector for Oracle by Attunity 和 Microsoft Connector for Teradata by Attunity（定目标到 SQL Server 2012）

• 自版本 3.3 起，该产品在安装时已派出了适用于 SQL Server 2017-2022 的 Power Query Source。 若要继续使用此组件，请自行手动下载并安装。 下载链接：适用于 SQL Server 2017-2022 的 Power Query Source

常见问题

• SSIS 执行包任务在 ExecuteOutOfProcess 设置为 True 时不支持调试。

• 尚不支持第三方组件。

• 有时，在 Visual Studio 实例升级期间，可能会删除此产品或 Visual Studio Tools for Applications 2022。 如果无法加载现有 SSIS 项目，请尝试通过控制面板修复此产品。 如果在选择 “编辑脚本”时 Visual Studio 未弹出，请尝试通过控制面板修复 VSTA 2022。

• SSDT 并排问题。 SQL Server Analysis Services 和 SQL Server Reporting Services 扩展现在可以与 Visual Studio 2022 17.4 和早期版本中的此扩展并行工作。 解决方法是下载 Visual Studio 2022 17.5 预览版 2 或更高版本。

• SQL Server Native Client (SNAC) 未随附：

  • SQL Server 2022 (16.x) 及更高版本
  • SQL Server Management Studio 19 及更高版本

  不建议在新应用开发中使用 SQL Server Native Client（SQLNCLI 或 SQLNCLI11）和旧版 Microsoft OLE DB Provider for SQL Server (SQLOLEDB)。

  对于新项目，请使用以下驱动程序之一：

  • Microsoft SQL Server ODBC 驱动程序
  • 适用于 SQL Server 的 Microsoft OLE DB 驱动程序

  对于作为 SQL Server 数据库引擎组件（版本 2012 到 2019）随附的 SQLNCLI，请参阅此支持生命周期特例。

• 如果在升级 SSDT 后找不到 Oracle、Teradata 或其他 OOB 组件，请确保安装了最新 SQL Server 版本的连接器。

已知问题

1. 在 Visual Studio 中对象（例如解决方案、包）的上下文菜单（鼠标右键）中，许多条目出现多次。
2. 有时，修复或更新 Visual Studio 时，可能会卸载 SSIS 扩展。 再次重新安装它。
3. 如果 SSIS 已成功安装，但解决方案资源管理器显示 incompatible，或 The application is not installed：
   1. 打开 Visual Studio 并导航到扩展>管理扩展>已安装
   2. 启用 SSIS 扩展
   3. 重新启动 Visual Studio

有关详细信息，请参阅 发行说明。

安装问题

安装日志文件Microsoft.DataTools.IntegrationServices_{Timestamp}_ISVsix.log位于 %temp%\SsdtisSetup 文件夹下。 检查日志文件中的错误消息，并按照以下故障排除步骤作：

1. 预检查验证 AnotherInstallationRunning 失败

   • 如果日志文件包含关键字： Pre-check verification failed with warning(s): AnotherInstallationRunning请继续等待并重试。
   • 发生此错误是因为 Windows Installer 会阻止安装。 Windows Installer 是 Windows 的子服务，用于管理 MSIs、Windows 更新或第三方组件等包的安装，并且一次只能处理一件事。

2. 其他错误

   • 下载 VSInstallationTroubleShooting.ps1 并在计算机上运行，以帮助进行故障排除。

脱机安装

按照以下步骤在脱机环境中安装此产品：

1. 请参阅创建 Visual Studio 的脱机安装包进行本地安装中的说明，并确保包含以下先决条件：

   • Prerequisite ID="Microsoft.VisualStudio.Component.Roslyn.LanguageServices" Version="[17.0,)" DisplayName="C# and Visual Basic"
   • Prerequisite ID="Microsoft.VisualStudio.Component.CoreEditor" Version="[17.0,)" DisplayName="Visual Studio core editor"
   • Prerequisite ID="Microsoft.Net.Component.4.7.TargetingPack" Version="[17.0,)" DisplayName=".NET Framework 4.7 targeting pack"

2. 启动此产品的安装程序并执行安装，也可以在安静模式下运行安装程序。 使用 /? 参数启动安装程序，以获取安装程序的参数列表的更多详细信息。

3. Visual Studio Community 不支持脱机激活。 若要将此产品与 Visual Studio Community 配合使用，必须偶尔在 Visual Studio Community 中登录到Microsoft帐户。 如果要在脱机环境中使用此产品，建议在 Visual Studio Professional 或 Enterprise 上安装此产品，该产品支持通过产品密钥进行脱机激活。