Développement d'objets personnalisés pour Integration Services
S’applique à :
SQL Server SSIS Integration Runtime dans Azure Data Factory
Lorsque les objets de flux de contrôle et de flux de données inclus dans SQL Server Integration Services ne répondent pas complètement à vos besoins, vous pouvez développer vos propres types d’objets personnalisés, notamment les suivants :
Tâches personnalisées.
Gestionnaires de connexions personnalisés. Connectez-vous aux sources de données externes qui ne sont pas prises en charge actuellement.
Modules fournisseurs d'informations personnalisés. Enregistrez des événements de package dans des formats qui ne sont pas pris en charge actuellement.
Énumérateurs personnalisés. Prenez en charge l'itération sur un jeu d'objets ou de formats de valeurs qui ne sont pas pris en charge actuellement.
Composants de flux de données personnalisés. Peuvent être configurés en tant que sources, transformations ou destinations.
Le modèle objet Integration Services facilite ce développement personnalisé à l'aide de classes de base qui fournissent un cadre cohérent et fiable pour votre implémentation personnalisée.
Si vous n'avez pas à réutiliser les fonctionnalités personnalisées dans plusieurs packages, la tâche de script et le composant Script vous donnent toute la puissance d'un langage de programmation managé avec beaucoup moins de code d'infrastructure à écrire. Pour plus d’informations, consultez Comparaison des solutions de script et des objets personnalisés.
Étapes de développement d'un objet personnalisé pour Integration Services
Lorsque vous développez un objet personnalisé à utiliser dans Integration Services, vous développez une bibliothèque de classes (DLL) qui sera chargée au moment de la conception et au moment de l'exécution par le Concepteur SSIS et par le runtime Integration Services. Les méthodes les plus importantes que vous devez implémenter ne sont pas celles que vous appelez à partir de votre propre code, mais celles que le runtime appelle à des moments appropriés pour initialiser et valider votre composant et appeler ses fonctionnalités.
Voici les étapes à suivre pour développer un objet personnalisé :
Créez un projet de type Bibliothèque de classes dans votre langage de programmation managé préféré.
Héritez de la classe de base appropriée, comme indiqué dans le tableau suivant.
Appliquez l'attribut approprié à votre nouvelle classe, comme indiqué dans le tableau suivant.
Remplacez les méthodes de la classe de base comme requis et écrivez le code des fonctionnalités personnalisées de votre objet.
Générez éventuellement une interface utilisateur personnalisée pour votre composant. Afin de faciliter le déploiement, vous pouvez développer l'interface utilisateur sous la forme d'un projet distinct au sein de la même solution, puis la générer en tant qu'assembly séparé.
(Facultatif) Affichez un lien vers des exemples et contenus d’Aide pour l’objet personnalisé dans la Boîte à outils SSIS.
Générez, déployez et déboguez votre nouvel objet personnalisé comme décrit dans Génération, déploiement et débogage d’objets personnalisés.
Classes de base, attributs et méthodes importantes
Ce tableau constitue une référence simple aux éléments les plus importants du modèle objet Integration Services pour chaque type d'objet personnalisé que vous pouvez développer.
| Objet personnalisé | Classe de base | Attribut | Méthodes importantes |
|---|---|---|---|
| Tâche | Task | DtsTaskAttribute | Execute |
| Gestionnaire de connexions | ConnectionManagerBase | DtsConnectionAttribute | AcquireConnection, ReleaseConnection |
| Module fournisseur d'informations | LogProviderBase | DtsLogProviderAttribute | OpenLog, Log, CloseLog |
| Énumérateur | ForEachEnumerator | DtsForEachEnumeratorAttribute | GetEnumerator |
| Composant de flux de données | PipelineComponent | DtsPipelineComponentAttribute | ProvideComponentProperties, PrimeOutput, ProcessInput |
Liens vers des exemples et des contenus d'aide
Pour afficher un lien dans la Boîte à outils SSIS vers des exemples et des contenus d’Aide pour un objet personnalisé écrit en code managé, utilisez les propriétés suivantes.
Microsoft.SqlServer.Dts.Pipeline.DTSPipelineComponentAttribute.SamplesTag*
Microsoft.SqlServer.Dts.Pipeline.DTSPipelineComponentAttribute.HelpCollection*
Microsoft.SqlServer.Dts.Pipeline.DTSPipelineComponentAttribute.HelpKeyword*
Microsoft.SqlServer.Dts.Runtime.DTSTaskAttribute.SamplesTag*
Microsoft.SqlServer.Dts.Runtime.DTSTaskAttribute.HelpCollection*
Microsoft.SqlServer.Dts.Runtime.DTSTaskAttribute.HelpKeyword*
Pour afficher un lien vers des exemples et des contenus d'Aide pour un objet personnalisé écrit en code natif, ajoutez des entrées dans le fichier de Registre Script (.rgs) pour SamplesTag, HelpKeyword et HelpCollection. Voici un exemple.
val HelpKeyword = s 'sql11.dts.designer.executepackagetask.F1'
val SamplesTag = s 'ExecutePackageTask'
Interface utilisateur personnalisée
Pour permettre aux utilisateurs de votre objet personnalisé de configurer ses propriétés, vous devrez peut-être également développer une interface utilisateur personnalisée. Dans les cas où une interface utilisateur personnalisée n'est pas strictement requise, vous pouvez choisir d'en créer une afin de fournir une interface plus conviviale que l'éditeur par défaut.
Dans un projet d’interface utilisateur personnalisée ou assembly, vous avez généralement deux classes : une classe qui implémente une interface Integration Services pour les interfaces utilisateur du type spécifique de l’objet personnalisé et le formulaire Windows qu’elle affiche pour collecter des informations auprès de l’utilisateur. Les interfaces que vous implémentez comportent uniquement quelques méthodes et une interface utilisateur personnalisée n'est pas difficile à développer.
Notes
De nombreux modules fournisseurs d’informations Integration Services ont une interface utilisateur personnalisée qui implémente l’objet IDtsLogProviderUI et remplace la zone de texte Configuration par la liste déroulante filtrée des gestionnaires de connexions disponibles. Toutefois, les interfaces utilisateur personnalisées des modules fournisseurs d'informations personnalisés ne sont pas implémentées dans cette version de Integration Services. La spécification d'une valeur pour la propriété UITypeName de l'objet DtsLogProviderAttribute est sans effet.
Le tableau suivant constitue une référence simple aux interfaces que vous devez implémenter lorsque vous développez une interface utilisateur personnalisée pour chaque type d'objet personnalisé. Il explique également ce que l’utilisateur voit si vous choisissez de ne pas développer d’interface utilisateur personnalisée pour votre objet, ou si vous ne parvenez pas à lier votre objet à son interface utilisateur en utilisant la propriété UITypeName dans l’attribut de l’objet. Bien que le puissant éditeur avancé puisse s'avérer satisfaisant pour un composant de flux de données, la fenêtre Propriétés est une solution moins conviviale pour les tâches et les gestionnaires de connexions, et un énumérateur ForEach personnalisé ne peut pas du tout être configuré sans formulaire personnalisé.
| Objet personnalisé | Classe de base pour interface utilisateur | Comportement d'édition par défaut si aucune interface utilisateur personnalisée n'est fournie |
|---|---|---|
| Tâche | IDtsTaskUI | Fenêtre Propriétés uniquement |
| Gestionnaire de connexions | IDtsConnectionManagerUI | Fenêtre Propriétés uniquement |
| Module fournisseur d'informations | IDtsLogProviderUI (Non implémenté dans Integration Services.) |
Zone de texte dans la colonne Configuration |
| Énumérateur | ForEachEnumeratorUI | Fenêtre Propriétés uniquement. La zone Configuration de l'énumérateur de l'éditeur est vide. |
| Composant de flux de données | IDtsComponentUI | Éditeur avancé |
Ressources externes
- Entrée de blog, Visual Studio solution build process give a warning about indirect dependency on the .NET Framework assembly due to SSIS references, sur blogs.msdn.com.
Voir aussi
Persistance des objets personnalisés
Génération, déploiement et débogage d’objets personnalisés
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour