支援自訂元件中的多目標

發行項
05/04/2023

適用於：SQL Server Azure Data Factory 中的 SSIS Integration Runtime

您現在可以在 SQL Server Data Tools (SSDT) 中使用 SSIS 設計工具，來建立、維護和執行目標為 SQL Server 2016、SQL Server 2014 或 SQL Server 2012 的套件。若要取得 SSDT for Visual Studio 2015，請參閱下載最新的 SQL Server Data Tools。

在方案總管中，在 Integration Services 專案上按一下滑鼠右鍵，然後選取 [屬性] 以開啟專案的屬性頁。在 [設定屬性] 的 [一般] 索引標籤中，選取 [TargetServerVersion] 屬性，然後選擇 SQL Server 2016、SQL Server 2014 或 SQL Server 2012。

專案屬性對話方塊中的 TargetServerVersion 屬性

自訂元件的多版本支援和多目標

全五種 SSIS 自訂延伸模組支援多目標。

連接管理員
工作
列舉值
記錄提供者
資料流程元件

針對受控延伸模組，SSIS 設計工具會載入指定目標版本的延伸模組版本。例如：

當目標版本為 SQL Server 2012 時，設計工具會載入延伸模組的 2012 版本。
當目標版本為 SQL Server 2016 時，設計工具會載入延伸模組的 2016 版本。

COM 延伸模組不支援多目標。無論指定的目標版本為何，SSIS 設計工具一律載入目前 SQL Server 版本的 COM 延伸模組。

新增多版本和多目標的基本支援

如需基本指引，請參閱 Getting your SSIS custom extensions to be supported by the multi-version support of SSDT 2015 for SQL Server 2016 (使用 SQL Server 2016 的 SSDT 2015 多版本支援來支援 SSIS 自訂延伸模組)。本部落格文章描述下列步驟或需求。

將您的組件部署到適當的資料夾。
建立 SQL Server 2014 和更新版本的延伸模組對應檔案。

新增程式碼以切換版本

在自訂連線管理員、工作、列舉值或記錄提供者中切換版本

若為自訂連線管理員、工作、列舉值或記錄提供者，請在 SaveToXML 方法中新增降級邏輯。

public void SaveToXML(XmlDocument doc, IDTSInfoEvents events)
{
    if (TargetServerVersion == DTSTargetServerVersion.SQLServer2014)
    {
        // Add logic to downgrade from SQL Server 2016 to SQL Server 2014.
    }

    if (TargetServerVersion == DTSTargetServerVersion.SQLServer2012)
    {
         // Add logic to downgrade from SQL Server 2016 to SQL Server 2012.
    }
}

在自訂資料流程元件中切換版本

若為自訂連線管理員、工作、列舉值或記錄提供者，請在 PerformDowngrade 方法中新增降級邏輯。

public override void PerformDowngrade(int pipelineVersion, DTSTargetServerVersion targetServerVersion)
{
    if (targetServerVersion == DTSTargetServerVersion.DTSTSV_SQLSERVER2014)
    {
        // Add logic to downgrade from SQL Server 2016 to SQL Server 2014.
        ComponentMetaData.Version = 8;
    }

    if (targetServerVersion == DTSTargetServerVersion.DTSTSV_SQLSERVER2012)
    {
          // Add logic to downgrade from SQL Server 2016 to SQL Server 2012.
        ComponentMetaData.Version = 6;
    }
}

常見錯誤

InvalidCastException

錯誤訊息。 無法將 'System.__ComObject' 類型的 COM 物件轉換成 'Microsoft.SqlServer.Dts.Pipeline.Wrapper.IDTSComponentMetaData100' 介面類型。這項作業失敗，因為 IID 為 '{BE8C48A3-155B-4810-BA5C-BDF68A659E9E}' 的介面之 COM 元件上的 QueryInterface 呼叫，因為發生下列錯誤而失敗：不支援這類介面 (來自 HRESULT 的例外狀況：0x80004002 (E_NOINTERFACE))。 (Microsoft.SqlServer.DTSPipelineWrap)。

解決方案。 如果您的自訂延伸模組參考 SSIS interop 組件，例如 Microsoft.SqlServer.DTSPipelineWrap 或 Microsoft.SqlServer.DTSRuntimeWrap，請將 [內嵌 Interop 類型] 屬性的值設成 False。

內嵌 Interop 類型

當目標版本是 SQL Server 2012 時無法載入某些類型

此問題會影響某些類型，例如 IErrorReportingService 或 IUserPromptService。

錯誤訊息 (範例)。 無法從組件 'Microsoft.DataWarehouse, Version=13.0.0.0, Culture=neutral, PublicKeyToken=89845dcd8080cc91' 載入類型 'Microsoft.DataWarehouse.Design.IErrorReportingService'。

因應措施。 當目標版本為 SQL Server 2012 時，請使用 MessageBox 而不是這些介面。

共用方式為