Gestionnaires d'événements Integration Services (SSIS)
Lors de l'exécution, les exécutables (packages, conteneurs de boucles Foreach, conteneurs de boucles For, conteneurs de séquences 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 gestionnaires 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.
Contenu du gestionnaire d'événements
La création d'un gestionnaire d'événements est similaire à la création d'un package. Un gestionnaire d'événements contient des tâches et des conteneurs qui sont mis en séquence de manière à former un flux de contrôle et peut inclure des flux de données. Le concepteur SSIS comprend un onglet Gestionnaires d’événements qui permet de créer des gestionnaires d’événements personnalisés. Pour plus d’informations, consultez Gestionnaires d’événements de package SSIS.
Vous pouvez également créer des gestionnaires d'événements par programme. Pour plus d’informations, consultez Gestion des erreurs et des avertissements.
Événements d'exécution
Le tableau qui suit énumère les gestionnaires d'événements fournis par Integration Services et décrit les événements d'exécution provoquant leur exécution.
| Gestionnaire d'événements | Événement |
|---|---|
OnError |
Gestionnaire d'événements de l'événement OnError. Cet événement est déclenché par un exécutable lorsqu'une erreur se produit. |
| OnExecStatusChanged | Gestionnaire d’événements de l’événement OnExecStatusChanged . Cet événement est déclenché par un exécutable lorsque son état d'exécution change. |
| OnInformation | Gestionnaire d’événements de l’événement OnInformation . Cet événement se déclenche au cours de la validation et de l'exécution d'un exécutable afin de rapporter des informations. Cet événement véhicule des informations uniquement (aucune erreur ni avertissement). |
| OnPostExecute | Gestionnaire d’événements de l’événement OnPostExecute . Cet événement est déclenché par un exécutable immédiatement après la fin de son exécution. |
| OnPostValidate | Gestionnaire d’événements de l’événement OnPostValidate . Cet événement est déclenché par un exécutable lorsque sa validation est terminée. |
| OnPreExecute | Gestionnaire d’événements de l’événement OnPreExecute . Cet événement est déclenché par un exécutable immédiatement avant son exécution. |
| OnPreValidate | Gestionnaire d’événements de l’événement OnPreValidate . Cet événement est déclenché par un exécutable lorsque sa validation démarre. |
| OnProgress | Gestionnaire d’événements de l’événement OnProgress . Cet événement est déclenché par un exécutable lorsqu'une progression mesurable est réalisée par l'exécutable. |
| OnQueryCancel | Gestionnaire d’événements de l’événement OnQueryCancel . Cet événement est déclenché par un exécutable pour déterminer si son exécution doit s'arrêter. |
| OnTaskFailed | Gestionnaire d’événements de l’événement OnTaskFailed . Cet événement est déclenché par une tâche lorsqu'elle échoue. |
| OnVariableValueChanged | Gestionnaire d’événements de l’événement OnVariableValueChanged . Cet événement est déclenché par un exécutable lorsque la valeur d'une variable change. L'événement est déclenché par l'exécutable sur lequel la variable est définie. Cet événement n’est pas déclenché si vous définissez la propriété RaiseChangeEvent pour la variable sur False. Pour plus d’informations, consultez Variables Integration Services (SSIS). |
| OnWarning | Gestionnaire d’événements de l’événement OnWarning . Cet événement est déclenché par un exécutable lorsqu'un avertissement se produit. |
Configuration d'un gestionnaire d'événements
Vous pouvez définir les propriétés dans la fenêtre Propriétés de SQL Server Data Tools (SSDT) ou par programmation.
Pour plus d’informations sur la définition de ces propriétés dans SQL Server Data Tools (SSDT), consultez Définir les propriétés d’une tâche ou d’un conteneur.
Pour plus d’informations sur la définition par programmation de ces propriétés, consultez DtsEventHandler.
Tâches associées
Pour plus d’informations sur l’ajout d’un gestionnaire d’événements à un package, consultez Ajouter un gestionnaire d’événements à un package.