VS2022 的 SSIS 项目扩展故障排除指南

项目
09/30/2024

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

重要

访问 https://techcommunity.microsoft.com/t5/SQL-Server-Integration-Services/bg-p/SSIS，直接从产品团队获取有关 SSIS 的最新信息、提示、新闻和公告。扩展市场中列出了集成服务 (SSIS) 扩展发行说明。

组件下载

要设计使用 Oracle 和 Teradata 连接器并且面向早于 SQL 2019 的旧版 SQL Server 的包，除 Microsoft Oracle Connector 和 Microsoft Teradata Connector 之外，还需要安装相应版本的 Microsoft Connector for Oracle by Attunity 和 Microsoft Connector for Teradata by Attunity。
自版本 3.3 起，该产品在安装时已派出了适用于 SQL Server 2017-2022 的 Power Query Source。若要继续使用此组件，请自行手动下载并安装。下载链接：适用于 SQL Server 2017-2022 的 Power Query Source

常见问题

当 ExecuteOutOfProcess 设置为“True”时，SSIS 执行包任务不支持调试。
尚不支持第三方组件。
有时，VS 实例升级期间可能会因某种原因删除此产品或 Visual Studio Tools for Applications 2022。如果无法加载现有 SSIS 项目，请尝试通过控制面板修复此产品。如果在选择“编辑脚本”时 VS 未弹出，请尝试通过控制面板修复 VSTA 2022。
SSDT 并排问题。 SQL Server Analysis Services 和 SQL Server Reporting Services 扩展现在可以与 VS2022 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 ODBC Driver for SQL Server
- 适用于 SQL Server 的 Microsoft OLE DB 驱动程序
对于作为 SQL Server 数据库引擎组件（版本 2012 到 2019）随附的 SQLNCLI，请参阅此支持生命周期特例。
如果在升级 SSDT 后找不到 Oracle、Teradata 或其他 OOB 组件，请确保已安装最新 SQL Server 版本的连接器。

已知问题

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

安装问题

如果已成功安装了 SSIS，但解决方案资源管理器显示“不兼容”或“未安装应用程序”：

打开“Visual Studio”->“扩展”->“管理扩展”->“已安装”
启用 SSIS 扩展
重新启动 Visual Studio

如果 SSIS 安装结果显示安装失败并显示“未知错误(0x80131500)”或“ISVsix 未知错误”，请打开 %temp%\SsdtisSetup 文件夹，然后在 Microsoft.DataTools.IntegrationServices_{latestTimestamp}_ISVsix.log 中搜索以下错误：

错误为“预检查验证失败，出现警告：AnotherInstallationRunning。”，
1. 继续等待并重试。更多详细信息：Windows Installer 阻止安装。 Windows Installer 是一项 Windows 子服务，用于管理 MSI、Windows 更新或第三方等包的安装，并且一次只能处理一个任务。

错误为“文件 {filefullpath} 已存在。”：

在提升的命令提示符下运行以下命令：

cd "C:\Program Files\Microsoft Visual Studio\2022\Professional\Common7\IDE\"
rm CommonExtensions\Microsoft\SSIS\*
rm PublicAssemblies\SSIS\*
rm "PublicAssemblies\Microsoft BI\Business Intelligence Projects\Integration Services\"*

通过 VS 安装程序修复 VS2022
重启电脑并重新安装 SSIS

错误为“对象引用未设置为某个对象的实例。”，
- 删除损坏的实例文件夹“%ProgramData%\Microsoft\VisualStudio\Packages_Instances<InstallationID>”
错误为“错误 0x80091007: 无法验证有效负载的哈希”，
- 删除 C:\ProgramData\Package Cache\15160B731819F56D87A626F9A2777550340022D7 并重试。

如果错误不属于上述列表中的任何一项，则可以压缩 %temp%\SsdtisSetup，然后将日志发送到 ssistoolsfeedbacks@microsoft.com 进行故障排除。

脱机安装

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

请参阅创建 Visual Studio 的脱机安装包进行本地安装中的说明，并确保包含以下先决条件：
- 先决条件 ID="Microsoft.VisualStudio.Component.Roslyn.LanguageServices" Version="[17.0,)" DisplayName="C# and Visual Basic"
- 先决条件 ID="Microsoft.VisualStudio.Component.CoreEditor" Version="[17.0,)" DisplayName="Visual Studio core editor"
- 先决条件 ID="Microsoft.Net.Component.4.7.TargetingPack" Version="[17.0,)" DisplayName=".NET Framework 4.7 targeting pack"
启动此产品的安装程序并执行安装，也可以在安静模式下运行安装程序。使用“/?”自变量启动安装程序，以获取安装程序自变量列表的更多详细信息。
VS Community 不支持脱机激活。若要将此产品与 VS Community 配合使用，必须在 VS Community 中偶尔登录到 Microsoft 帐户。如果要在脱机环境中使用此产品，建议在支持通过产品密钥进行脱机激活的 VS Professional 或 Enterprise 上安装此产品。

通过