建立自訂連接管理員

發行項
05/04/2023

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

建立自訂連接管理員的步驟，與建立整合服務之其他自訂物件的步驟類似：

建立繼承自基底類別的新類別。對於連接管理員而言，基底類別是 ConnectionManagerBase。
將可識別物件類型的屬性套用至類別。對於連接管理員而言，屬性是 DtsConnectionAttribute。
覆寫基底類別之方法與屬性的實作。對於連接管理員而言，這些包括 ConnectionString 屬性以及 AcquireConnection 與 ReleaseConnection 方法。
(選擇性) 開發自訂使用者介面。對於連接管理員而言，這需要實作 IDtsConnectionManagerUI 介面的類別。

注意

大多數已建置到 Integration Services 中的工作、來源和目的地，只能搭配特定類型的內建連線管理員一起使用。因此，不能使用內建工作和元件來測試這些範例。

開始使用自訂連接管理員

建立專案和類別

因為所有的 Managed 連接管理員都是從 ConnectionManagerBase 基底類別衍生，所以建立自訂連接管理員的第一個步驟是以慣用的 Managed 程式語言建立類別庫專案，並建立繼承自基底類別的類別。在此衍生的類別中，您將覆寫基底類別的方法與屬性，以實作自訂功能。

在相同的方案中，為自訂使用者介面建立另一個類別庫專案。之所以建議您為使用者介面建立個別的組件，是因為它可讓您分別更新和重新部署連接管理員或其使用者介面，從而簡化部署的工作。

透過使用強式名稱金鑰檔案，將兩個專案都設定成簽署將在建立時期產生的組件。

套用 DtsConnection 屬性

將 DtsConnectionAttribute 屬性套用至您已建立的類別，以便將它識別為連接管理員。此屬性會提供連接管理員的名稱、描述和連接類型等設計階段資訊。 ConnectionType 與 Description 屬性會對應至顯示在 [加入 SSIS 連線管理員] 對話方塊中的 [類型] 與 [描述] 資料行，這個對話方塊將在為 SQL Server Data Tools (SSDT) 中的套件設定連接時顯示。

使用 UITypeName 屬性將連接管理員連結至其自訂使用者介面。如需取得此屬性所需的公開金鑰權杖，可以使用 sn.exe -t，從要用於簽署使用者介面組件的金鑰組 (.snk) 檔案顯示公開金鑰權杖。

<DtsConnection(ConnectionType:="SQLVB", _  
  DisplayName:="SqlConnectionManager (VB)", _  
  Description:="Connection manager for Sql Server", _  
  UITypeName:="SqlConnMgrUIVB.SqlConnMgrUIVB,SqlConnMgrUIVB,Version=1.0.0.0,Culture=neutral,PublicKeyToken=<insert public key token here>")> _  
Public Class SqlConnMgrVB  
  Inherits ConnectionManagerBase  
  . . .  
End Class

[DtsConnection(ConnectionType = "SQLCS",  
  DisplayName = "SqlConnectionManager (CS)",  
  Description = "Connection manager for Sql Server",  
  UITypeName = "SqlConnMgrUICS.SqlConnMgrUICS,SqlConnMgrUICS,Version=1.0.0.0,Culture=neutral,PublicKeyToken=<insert public key token here>")]  
public class SqlConnMgrCS :  
ConnectionManagerBase  
{  
  . . .  
}

建立、部署和偵錯自訂連接管理員

在整合服務中建立、部署和偵錯自訂連接管理員的步驟，類似於其他類型的自訂物件所需的步驟。如需詳細資訊，請參閱建立、部署和偵錯自訂物件。

另請參閱

撰寫自訂連接管理員的程式碼
 開發自訂連接管理員的使用者介面

Share via