通过

适用于 Visual Studio 2019 的 SSIS 项目扩展故障排除指南

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

重要

可以从 Visual Studio Marketplace 下载 SQL Server Integration Services （SSIS） 扩展。

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

组件下载

常见问题

  • 当 ExecuteOutOfProcess 设置为“True”时，SSIS 执行包任务不支持调试。

  • 此扩展不支持 Visual Studio 2022。 请使用 SQL Server Integration Services 项目扩展 2022。

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

  • 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)。

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

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

已知问题

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

安装问题

如果 SSIS 已成功安装，但解决方案资源管理器显示 incompatible，或 The application is not installed：

  1. 打开 Visual Studio 并导航到扩展>管理扩展>已安装
  2. 启用 SSIS 扩展
  3. 重新启动 Visual Studio

如果 SSIS 安装显示安装失败，则在Unknown error(0x80131500)或ISVsix Unknown error情况下，打开%temp%\SsdtisSetup文件夹，然后在Microsoft.DataTools.IntegrationServices_{latestTimestamp}_ISVsix.log中搜索。

  • 错误为 Pre-check verification failed with warning(s): AnotherInstallationRunning.，

    1. 继续等待并重试。 更多详细信息：Windows Installer 阻止安装。 Windows Installer 是 Windows 的子服务，用于管理 MSIs、Windows 更新或第三方组件等包的安装，并且一次只能处理一件事。

  • 错误为 The file {filefullpath} already exists.：

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

      cd C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\Common7\IDE
rm CommonExtensions\Microsoft\SSIS\*
rm PublicAssemblies\SSIS\*
rm "PublicAssemblies\Microsoft BI\Business Intelligence Projects\Integration Services\"*

    2. 通过 Visual Studio 安装程序修复 Visual Studio 2019

    3. 重启电脑并重新安装 SSIS

  • 错误为 Object reference not set to an instance of an object.，

    • 删除损坏的实例文件夹 %ProgramData%\Microsoft\VisualStudio\Packages\_Instances\<InstallationID>

  • 错误为 Error 0x80091007: Failed to verify hash of payload，

    • 删除 C:\ProgramData\Package Cache\15160B731819F56D87A626F9A2777550340022D7 并重试。

  • 如果错误不在前面的列表中，可以压缩 %temp%\SsdtisSetup 并将日志发送到 ssistoolsfeedbacks@microsoft.com 进行故障排除。

脱机安装

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

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

    • Prerequisite ID="Microsoft.VisualStudio.Component.Roslyn.LanguageServices" Version="[16.0,)" DisplayName="C# and Visual Basic"
    • Prerequisite ID="Microsoft.VisualStudio.Component.CoreEditor" Version="[16.0,)" DisplayName="Visual Studio core editor"
    • Prerequisite ID="Microsoft.VisualStudio.Component.SQL.SSDT" Version="[16.0,)" DisplayName="SQL Server Data Tools"
    • Prerequisite ID="Microsoft.Net.Component.4.TargetingPack" Version="[16.0,)" DisplayName=".NET Framework 4 targeting pack"
    • Prerequisite ID="Microsoft.Net.Component.4.5.TargetingPack" Version="[16.0,)" DisplayName=".NET Framework 4.5 targeting pack"
    • Prerequisite ID="Microsoft.Net.Component.4.7.TargetingPack" Version="[16.0,)" DisplayName=".NET Framework 4.7 targeting pack"

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

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

  • Last updated on