VS2019 的 SSIS 專案延伸模組疑難排解指南

適用於：SQL ServerAzure SQL DatabaseAzure Synapse Analytics

重要

您可以從 Visual Studio Marketplace，下載SSIS。

前往 https://techcommunity.microsoft.com/t5/SQL-Server-Integration-Services/bg-p/SSIS，即可直接從產品小組取得有關 SSIS 的最新資訊、提示、新聞和公告。 Integration Services (SSIS) 擴充功能版本資訊會列在延伸模組市集上。

元件下載

• 若要使用 Oracle 和 Teradata 連接器來設計套件，並將目標設為 SQL Server 2019 之前的舊版 SQL Server，則除了 Microsoft Oracle Connector 和 Microsoft Teradata Connector 之外，還需要安裝由 Attunity 提供且適用於 Oracle 和 Teradata 的 Microsoft Connector 相應版本。

  • 由 Attunity 提供的 Microsoft 連接器 5.0 版，適用於 Oracle 和 Teradata，目標 SQL Server 2017
  • Microsoft 連接器 4.0 版，適用於 Oracle 和 Teradata 由 Attunity 提供，針對 SQL Server 2016
  • 由 Attunity 提供的適用於 Oracle 和 Teradata 的 Microsoft 連接器 3.0 版，目標為 SQL Server 2014
  • Microsoft 連接器 2.0 版，適用於 Oracle 和 Teradata，目標為 SQL Server 2012，由 Attunity 開發

• 自 3.3 版起，SQL Server 2017-2022 的 Power Query Source 已從此產品的安裝中排除。 若要繼續使用此元件，請自行手動下載並加以安裝。 以下是下載連結：SQL Server 2017-2022 的 Power Query Source

常見問題

• 當 ExecuteOutOfProcess 設定為 True 時，SSIS 執行套件工作不支援偵錯。

• 此延伸模組不支援 Visual Studio 2022。 請使用 SQL Server Integration Services 專案延伸模組 2022。

• 有時候，此產品或 Visual Studio Tools for Applications 2019 在升級 VS 執行個體期間，可能會不明原因地刪除。 如果無法載入現有的 SSIS 專案，請嘗試透過控制台修復此產品。 如果在按一下 [編輯指令碼] 時 VS 無法啟動，請嘗試透過控制台修復 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) 進行新的應用開發。

  針對新專案，請使用下列其中一個驅動程式：

  • Microsoft ODBC Driver for SQL Server
  • Microsoft OLE DB Driver for SQL Server

  針對 SQL Server 資料庫引擎 (2012 到 2019 版) 的隨附元件 SQLNCLI，請參閱支援生命週期例外狀況。

已知問題

版本資訊中的詳細資料。

安裝問題

如果成功安裝 SSIS，但方案總管顯示「不相容」或「未安裝應用程式」：

1. 開啟 Visual Studio -> 擴充功能 -> 管理擴充功能 -> 已安裝
2. 啟用 SSIS 延伸模組
3. 重新啟動 Visual Studio

如果 SSIS 安裝顯示安裝程式失敗，並出現「未知錯誤 (0x80131500)」或「ISVsix 未知錯誤」，請開啟 %temp%\SsdtisSetup 資料夾，搜尋 Microsoft.DataTools.IntegrationServices_{latestTimestamp}_ISVsix.log：

• 當錯誤為「預先檢查驗證失敗，並出現警告：AnotherInstallationRunning。」，

  1. 繼續等候並重試。 更多詳細資料：Windows Installer 會封鎖您的安裝。 Windows Installer 是 Windows 的子服務，可管理 MSIS、Windows Update 或第三方專案等套件的安裝，而且一次只能處理一件事。

• 錯誤：「檔案 {filefullpath} 已經存在。」

  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. 透過 VS 安裝程式修復 VS2019
  3. 重新啟動電腦並重新安裝 SSIS

• 錯誤為「未將物件參考設定為物件的執行個體。」

  • 刪除中斷的執行個體資料夾 "%ProgramData%\Microsoft\VisualStudio\Packages_Instances<執行個體識別碼>"

• 錯誤為「錯誤 0x80091007：無法驗證有效載荷的雜湊」。

  • 刪除 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"
   • 先決條件 ID="Microsoft.Net.Component.4.5.TargetingPack" 版本="[16.0,)" 顯示名稱=".NET Framework 4.5 定位套件"
   • 前提 ID="Microsoft.Net.Component.4.7.TargetingPack" 版本="[16.0,)" 顯示名稱=".NET Framework 4.7 目標套件"

2. 啟動本產品的安裝程式並執行安裝，或是以無訊息模式執行安裝程式。 啟動安裝程式時使用 "/?" 引數，取得安裝程式引數清單的詳細資料。

3. VS Community 不支援離線啟用。 若要搭配 VS Community 使用此產品，必須偶爾在 VS Community 中登入您的 Microsoft 帳戶。 如果想要在離線的環境中使用此產品，建議在支援透過產品金鑰進行離線啟用的 VS Professional 或 Enterprise 上安裝本產品。