Auslösen von Ereignissen in der Skriptkomponente

Gilt für: SQL Server SSIS Integration Runtime in Azure Data Factory

Ereignisse bieten eine Möglichkeit, Fehler, Warnungen und andere Informationen, wie z. B. den Fortschritt oder Status eines Tasks, an das entsprechende Paket zu melden. Das Paket stellt Ereignishandler zum Verwalten von Ereignisbenachrichtigungen bereit. Die Skriptkomponente kann Ereignisse durch Aufrufen der Methoden in der ComponentMetaData-Eigenschaft der ScriptMain-Klasse auslösen. Weitere Informationen zum Umgang von Integration Services-Paketen mit Ereignissen finden Sie unter Integration Services-Ereignishandler (SSIS).

Ereignisse können in jedem Protokollanbieter protokolliert werden, der im Paket aktiviert wird. Protokollanbieter speichern Informationen über Ereignisse in einem Datenspeicher. Die Skriptkomponente kann ebenfalls die Log-Methode verwenden, um Informationen in einem Protokollanbieter zu protokollieren, ohne ein Ereignis auszulösen. Weitere Informationen zur Verwendung der Log-Methode finden Sie im folgenden Abschnitt.

Um ein Ereignis auszulösen, ruft der Skripttask eine der folgenden Methoden der IDTSComponentMetaData100-Schnittstelle auf, die von der ComponentMetaData-Eigenschaft verfügbar gemacht wird:

Ereignis	BESCHREIBUNG
FireCustomEvent	Löst ein benutzerdefiniertes Ereignis im Paket aus.
FireError	Informiert das Paket über eine Fehlerbedingung.
FireInformation	Stellt Informationen für den Benutzer bereit.
FireProgress	Informiert das Paket über den Fortschritt der Komponente.
FireWarning	Informiert das Paket darüber, dass die Komponente einen Status aufweist, der eine Benutzerbenachrichtigung erfordert, bei dem es sich aber nicht um eine Fehlerbedingung handelt.

Nachfolgend finden Sie ein einfaches Beispiel zur Auslösung eines Error-Ereignisses:

Dim myMetadata as IDTSComponentMetaData100

myMetaData = Me.ComponentMetaData

myMetaData.FireError(...)

Weitere Informationen

Integration Services-Ereignishandler (SSIS)
Hinzufügen eines Ereignishandlers zu einem Paket