Erstellen eines benutzerdefinierten Verbindungs-Managers

Artikel
05/23/2023

Gilt für: SQL Server SSIS Integration Runtime in Azure Data Factory

Die durchzuführenden Schritte zum Erstellen eines benutzerdefinierten Verbindungs-Managers ähneln denen jedes anderen benutzerdefinierten Objekts für Integration Services:

Erstellen Sie eine neue Klasse, die von der Basisklasse erbt. Bei einem Verbindungs-Manager ist die Basisklasse ConnectionManagerBase.
Weisen Sie das Attribut zu, das den Typ des Objekts für die Klasse identifiziert. Bei einem Verbindungs-Manager ist das Attribut DtsConnectionAttribute.
Überschreiben Sie die Implementierung der Methoden und Eigenschaften der Basisklasse. Bei einem Verbindungs-Manager gehören dazu die ConnectionString-Eigenschaft sowie die AcquireConnection-Methode und die ReleaseConnection-Methode.
Entwickeln Sie optional eine individuelle Benutzeroberfläche. Bei einem Verbindungs-Manager ist dazu eine Klasse erforderlich, die die IDtsConnectionManagerUI-Schnittstelle implementiert.

Hinweis

Die meisten Tasks, Quellen und Ziele, die in Integration Services integriert wurden, können nur mit bestimmten Typen integrierter Verbindungs-Manager verwendet werden. Daher können diese Beispiele nicht mit den integrierten Tasks und Komponenten getestet werden.

Erste Schritte mit einem benutzerdefinierten Verbindungs-Manager

Erstellen von Projekten und Klassen

Da alle verwalteten Verbindungs-Manager von der ConnectionManagerBase-Basisklasse abgeleitet sind, besteht der erste Schritt beim Erstellen eines benutzerdefinierten Verbindungs-Managers darin, in Ihrer bevorzugten verwalteten Programmiersprache ein Klassenbibliotheksprojekt anzulegen und eine Klasse zu generieren, die von der Basisklasse erbt. In dieser abgeleiteten Klasse überschreiben Sie die Methoden und Eigenschaften der Basisklasse, um die benutzerdefinierten Funktionen zu implementieren.

Erstellen Sie in der gleichen Lösung ein zweites Klassenbibliotheksprojekt für die individuelle Benutzeroberfläche. Für eine einfache Bereitstellung sollten Sie eine eigene Assembly für die Benutzeroberfläche verwenden, da Sie so den Verbindungs-Manager oder seine Benutzeroberfläche unabhängig aktualisieren und erneut bereitstellen können.

Konfigurieren Sie beide Projekte für das Signieren der Assemblys, die bei der Erstellung erzeugt werden, mit einer Schlüsseldatei mit starkem Namen.

Zuweisen des 'DtsConnection'-Attributs

Weisen Sie das DtsConnectionAttribute-Attribut der Klasse zu, die Sie erstellt haben, um sie als Verbindungs-Manager zu kennzeichnen. Dieses Attribut stellt Entwurfszeitinformationen bereit, z. B. Name, Beschreibung und Verbindungstyp des Verbindungs-Managers. Die Eigenschaften ConnectionType und Description entsprechen den Spalten Typ und Beschreibung, die im Dialogfeld SSIS-Verbindungs-Manager hinzufügen angezeigt werden. Das Dialogfeld wird beim Konfigurieren von Verbindungen für ein Paket in SQL Server Data Tools (SSDT) geöffnet.

Verwenden Sie die UITypeName-Eigenschaft, um den Verbindungs-Manager mit der individuellen Benutzeroberfläche zu verknüpfen. Um das für diese Eigenschaft erforderliche öffentliche Schlüsseltoken zu erhalten, können Sie sn.exe -t verwenden. Damit zeigen Sie das öffentliche Schlüsseltoken aus der Schlüsselpaardatei (.snk) an, die Sie für das Signieren der Benutzeroberflächenassembly verwenden möchten.

<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  
{  
  . . .  
}

Erstellen, Bereitstellen und Debuggen eines benutzerdefinierten Verbindungs-Managers

Die Schritte zum Erstellen, Bereitstellen und Debuggen eines benutzerdefinierten Verbindungs-Managers in Integration Services ähneln denen für andere Typen benutzerdefinierter Objekte. Weitere Informationen finden Sie unter Building, Deploying, and Debugging Custom Objects (Erstellen, Bereitstellen und Debuggen von benutzerdefinierten Objekten).

Weitere Informationen

Codieren eines benutzerdefinierten Verbindungs-Managers
Entwickeln einer Benutzeroberfläche für einen benutzerdefinierten Verbindungs-Manager

Freigeben über