Déclenchement d'événements dans le composant Script
S’applique à :
SQL Server SSIS Integration Runtime dans Azure Data Factory
Les événements offrent un moyen de signaler des erreurs, des avertissements et d'autres informations, telles que la progression ou l'état d'une tâche, au package conteneur. Le package fournit des gestionnaires d'événements pour gérer les notifications d'événements. Le composant Script peut déclencher des événements en appelant des méthodes sur la propriété ComponentMetaData de la classe ScriptMain. Pour plus d’informations sur la manière dont les packages Integration Services gèrent les événements, consultez Gestionnaires d’événements Integration Services (SSIS).
Les événements peuvent être journalisés dans tout module fournisseur d'informations activé dans le package. Les modules fournisseurs d'informations stockent des informations à propos des événements dans une banque de données. Le composant Script peut également utiliser la méthode Log pour journaliser des informations dans un module fournisseur d'informations sans déclencher d'événement. Pour plus d'informations sur la manière d'utiliser la méthode Log, consultez la section suivante.
Pour déclencher un événement, la tâche de script appelle l'une des méthodes suivantes de l'interface IDTSComponentMetaData100 exposée par la propriété ComponentMetaData :
| Événement | Description |
|---|---|
| FireCustomEvent | Déclenche un événement personnalisé défini par l'utilisateur dans le package. |
| FireError | Informe le package d'une condition d'erreur. |
| FireInformation | Fournit des informations à l'utilisateur. |
| FireProgress | Informe le package de la progression du composant. |
| FireWarning | Informe le package que le composant est dans un état qui garantit la notification de l'utilisateur, mais qui n'est pas une condition d'erreur. |
Voici un exemple simple de génération d'un événement d'erreur :
Dim myMetadata as IDTSComponentMetaData100
myMetaData = Me.ComponentMetaData
myMetaData.FireError(...)
Voir aussi
Gestionnaires d'événements Integration Services (SSIS)
Ajouter un gestionnaire d’événements à un package