Een aangepast verbindingsbeheer maken

Van toepassing op:SQL Server SSIS Integration Runtime in Azure Data Factory

De stappen die je moet volgen om een custom connection manager te maken, lijken op die voor het maken van elk ander aangepast object voor Integration Services:

• Maak een nieuwe klasse aan die erft van de basisklasse. Voor een verbindingsmanager is ConnectionManagerBasede basisklasse .

• Pas het attribuut toe dat het type object identificeert op de klasse. Voor een verbindingsmanager is DtsConnectionAttributehet attribuut .

• Overschrijf de implementatie van de methoden en eigenschappen van de basisklasse. Voor een verbindingsbeheerder omvatten deze de ConnectionString property- en de AcquireConnection en-methoden ReleaseConnection .

• Ontwikkel optioneel een aangepaste gebruikersinterface. Voor een verbindingsmanager is hiervoor een klasse nodig die de IDtsConnectionManagerUI interface implementeert.

Beginnen met een aangepaste Verbindingsbeheer

Projecten en Cursussen Creëren

Omdat alle managed connection managers afkomstig zijn van de ConnectionManagerBase basisklasse, is de eerste stap bij het maken van een custom connection manager het maken van een class library-project in je favoriete beheerde programmeertaal en het creëren van een klasse die erft van de basisklasse. In deze afgeleide klasse overschrijf je de methoden en eigenschappen van de basisklasse om je aangepaste functionaliteit te implementeren.

Maak in dezelfde oplossing een bibliotheekproject van de tweede klasse voor de aangepaste gebruikersinterface. Een aparte assembly voor de gebruikersinterface wordt aanbevolen voor het gemak van de implementatie, omdat je hiermee de verbindingsmanager of de gebruikersinterface onafhankelijk kunt updaten en opnieuw uitrolen.

Configureer beide projecten om de assemblies te signeren die tijdens de bouw worden gegenereerd door gebruik te maken van een strong name key-bestand.

Het toepassen van het attribuut DtsConnection

Pas het DtsConnectionAttribute attribuut toe op de klasse die je hebt aangemaakt om deze als verbindingsmanager te identificeren. Dit attribuut geeft ontwerptijd-informatie zoals de naam, beschrijving en verbindingstype van de verbindingsmanager. De eigenschappen en BeschrijvingConnectionType komen overeen met de kolommen Type en Beschrijving die worden weergegeven in het venster Add SSIS Verbindingsbeheer, dat wordt weergegeven bij het configureren van verbindingen voor een pakket in SQL Server Data Tools (SSDT).

Gebruik de UITypeName eigenschap om de verbindingsmanager te koppelen aan de aangepaste gebruikersinterface. Om het publieke sleuteltoken te verkrijgen dat voor deze eigenschap vereist is, moet je sn.exe -t gebruiken om het publieke sleuteltoken uit het sleutelpaar (.snk) bestand te tonen dat je wilt gebruiken om de gebruikersinterface-assembly te ondertekenen.

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

Een aangepaste Verbindingsbeheer bouwen, uitrollen en debuggen

De stappen voor het bouwen, uitrollen en debuggen van een custom connection manager in Integration Services lijken op die van andere soorten custom objects. Voor meer informatie, zie Bouwen, Uitrollen en Debuggen van Aangepaste Objecten.

Verwante onderwerpen

• Een aangepaste Verbindingsbeheer coderen
• Een gebruikersinterface ontwikkelen voor een aangepaste Verbindingsbeheer