Création d'un gestionnaire de connexions personnalisé

Article
05/23/2023

S’applique à : SQL Server SSIS Integration Runtime dans Azure Data Factory

Les étapes à suivre pour créer un gestionnaire de connexions personnalisé sont similaires à celles permettant de créer tout autre objet personnalisé pour Integration Services :

Créer une classe qui hérite de la classe de base. Pour un gestionnaire de connexions, la classe de base est ConnectionManagerBase.
Appliquer l'attribut qui identifie le type d'objet auprès de la classe. Pour un gestionnaire de connexions, l'attribut est DtsConnectionAttribute.
Remplacer l'implémentation des méthodes et propriétés de la classe de base. Pour un gestionnaire de connexions, celles-ci incluent la propriété ConnectionString et les méthodes AcquireConnection et ReleaseConnection.
Développer éventuellement une interface utilisateur personnalisée. Pour un gestionnaire de connexions, cette opération requiert une classe qui implémente l'interface IDtsConnectionManagerUI.

Notes

Une grande partie des tâches, sources et destinations intégrées à Integration Services utilisent uniquement des types spécifiques de gestionnaires de connexions intégrés. Par conséquent, ces exemples ne peuvent pas être testés avec les tâches et composants intégrés.

Mise en route d'un gestionnaire de connexions personnalisé

Création de projets et de classes

Puisque tous les gestionnaires de connexions managés dérivent de la classe de base ConnectionManagerBase, la première étape de création d'un gestionnaire de connexions personnalisé consiste à créer un projet Bibliothèque de classes dans votre langage de programmation managé par défaut et à créer une classe qui hérite de la classe de base. Dans cette classe dérivée, vous allez substituer les méthodes et les propriétés de la classe de base pour implémenter vos fonctionnalités personnalisées.

Dans la même solution, créez un deuxième projet Bibliothèque de classes pour l'interface utilisateur personnalisée. Il est recommandé d’utiliser un assembly distinct pour l’interface utilisateur afin de faciliter le déploiement car vous pouvez ainsi mettre à jour et redéployer le gestionnaire de connexions ou son interface utilisateur de manière indépendante.

Configurez les deux projets pour qu'ils signent les assemblys qui seront créés au moment de la génération à l'aide d'un fichier de clé de nom fort.

Application de l'attribut DtsConnection

Appliquez l'attribut DtsConnectionAttribute à la classe que vous avez créée pour l'identifier en tant que gestionnaire de connexions. Cet attribut fournit des informations au moment de la conception, telles que le nom, la description et le type de connexion du gestionnaire de connexions. Les propriétés ConnectionType et Description correspondent aux colonnes Type et Description qui apparaissent dans la boîte de dialogue Ajout d’un gestionnaire de connexions SSIS, laquelle s’affiche lorsque vous configurez des connexions pour un package dans SQL Server Data Tools (SSDT).

Utilisez la propriété UITypeName pour lier le gestionnaire de connexions à son interface utilisateur personnalisée. Pour obtenir le jeton de clé publique requis pour cette propriété, vous pouvez utiliser sn.exe -t de manière à afficher le jeton de clé publique du fichier de paire de clés (.snk) que vous voulez utiliser pour signer l’assembly de l’interface utilisateur.

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

Génération, déploiement et débogage d'un gestionnaire de connexions personnalisé

Les étapes permettant de générer, déployer et déboguer un gestionnaire de connexions personnalisé dans Integration Services sont très similaires aux étapes requises pour les autres types d'objets personnalisés. Pour plus d’informations, consultez Génération, déploiement et débogage d’objets personnalisés.

Voir aussi

Codage d'un gestionnaire de connexions personnalisé
Développement d'une interface utilisateur pour un gestionnaire de connexions personnalisé

Partager via