Partager via

Déclenchement d'événements dans le composant Script

  • Article

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