Gestionnaires d'événements d'Integration Services

Lors de l'exécution, les exécutables (packages, conteneurs de boucles Foreach, conteneurs de boucles For, conteneurs Sequence et conteneurs d'hôtes de tâches) déclenchent des événements. Par exemple, un événement OnError se déclenche lorsqu'une erreur se produit. Vous pouvez créer des gestionnaires d'événements personnalisés pour ces événements afin d'étendre les fonctionnalités des packages et les rendre plus faciles à gérer au moment de l'exécution. Les gestionnaires d'événements peuvent réaliser des tâches comme les suivantes :

• nettoyer l'emplacement de stockage des données temporaires une fois l'exécution d'un package ou d'une tâche terminée ;

• récupérer les informations système de manière à évaluer la disponibilité des ressources avant exécution d'un package ;

• actualiser les données d'une table en cas d'échec d'une recherche dans une table de référence ;

• envoyer un message électronique lorsqu'une erreur ou un avertissement se produit ou lorsqu'une tâche échoue.

Si un événement ne possède pas de gestionnaire d'événements, il est remonté au conteneur qui se trouve un niveau au-dessus dans la hiérarchie des conteneurs d'un package. Si ce conteneur possède un gestionnaire d'événements, ce dernier est exécuté en réponse à l'événement. Dans le cas contraire, l'événement est remonté au conteneur qui se trouve un niveau au-dessus dans la hiérarchie des conteneurs.

Le diagramme qui suit montre un package simple composé d'un conteneur de boucles For contenant une tâche d'exécution SQL.

Seul le package possède un gestionnaire d'événements (pour son événement OnError). Si une erreur se produit pendant l'exécution de la tâche d'exécution SQL, le gestionnaire d'événements OnError du package s'exécute. Le diagramme qui suit montre la séquence d'appels qui conduit à l'exécution du gestionnaire d'événements OnError du package.

Les gestionnaires d'événements sont membres d'une collection de gestionnaires d'événements. Tous les conteneurs incluent cette collection. Si vous créez le package à l'aide du concepteur SSIS, vous pouvez afficher les membres des collections de gestionnaire d'événements dans les dossiers Gestionnaires d'événements de l'onglet Explorateur de package du concepteur SSIS.

Vous pouvez configurer le conteneur du gestionnaire d'événements de plusieurs manières :

• indiquez le nom et la description du gestionnaire d'événements ;

• indiquez si le gestionnaire d'événements s'exécute, si le package échoue en cas d'échec du gestionnaire d'événements et indiquez le nombre d'erreurs autorisées avant échec du gestionnaire d'événements ;

• spécifiez un résultat d'exécution à renvoyer à la place du résultat d'exécution réel renvoyé au moment de l'exécution par le gestionnaire d'événements ;

• spécifiez l'option de transaction du gestionnaire d'événements ;

• spécifiez le mode de journalisation utilisé par le gestionnaire d'événements.