Ereignishandler von SQL Server Integration Services

Zur Laufzeit lösen ausführbare Dateien (Pakete und Foreach-Schleifencontainer, For-Schleifencontainer, Sequenzcontainer und Taskhostcontainer) Ereignisse aus . Beispielsweise wird ein OnError-Ereignis ausgelöst, wenn ein Fehler auftritt. Sie können benutzerdefiniert Ereignishandler für diese Ereignisse erstellen, um die Paketfunktionalität zu erweitern und die Verwaltung der Pakete zur Laufzeit zu vereinfachen. Mit Ereignishandlern können folgende Aufgaben ausgeführt werden:

• Cleanup des temporären Datenspeichers, wenn die Ausführung eines Pakets oder Tasks beendet ist.

• Abrufen von Systeminformationen, um die Ressourcenverfügbarkeit zu bewerten, bevor ein Paket ausgeführt wird.

• Aktualisieren von Daten in einer Tabelle, wenn bei einer Suche in einer Verweistabelle ein Fehler auftritt.

• Senden einer E-Mail-Nachricht bei einem Fehler oder einer Warnung oder bei einem Fehler im Zusammenhang mit einem Task.

Falls ein Ereignis keinen Ereignishandler aufweist, wird das Ereignis im nächsten übergeordneten Container der Containerhierarchie in einem Paket ausgelöst. Wenn dieser Container einen Ereignishandler aufweist, wird der Ereignishandler als Antwort auf das Ereignis ausgeführt. Andernfalls wird das Ereignis im nächsten übergeordneten Container der Containerhierarchie ausgelöst.

Im folgenden Diagramm wird ein einfaches Paket mit einem For-Schleifencontainer, der einen Task SQL ausführen enthält, angezeigt.

Nur das Paket hat einen Ereignishandler, und zwar für das OnError-Ereignis. Wenn beim Ausführen des Tasks SQL ausführen ein Fehler auftritt, wird der OnError-Ereignishandler für das Paket ausgeführt. Im folgenden Diagramm wird die Aufrufsequenz angezeigt, durch die der OnError-Ereignishandler für das Paket ausgeführt wird.

Ereignishandler sind Elemente einer Ereignishandlerauflistung, und alle Container schließen diese Auflistung ein. Wenn Sie das Paket mit dem SSIS-Designer erstellen, können Sie die Elemente der Ereignishandlerauflistungen im Ordner Ereignishandler auf der Registerkarte Paket-Explorer des SSIS-Designers anzeigen.

Es gibt folgende Möglichkeiten, um den Ereignishandlercontainer zu konfigurieren:

• Geben Sie einen Namen und eine Beschreibung für den Ereignishandler an.

• Geben Sie an, ob der Ereignishandler ausgeführt wird, ob für das Paket bei einem Ereignishandlerfehler ein Fehler gemeldet wird und nach wie vielen Fehlern der Ereignishandler einen Fehler meldet.

• Geben Sie ein Ausführungsergebnis an, das anstelle des vom Ereignishandler zur Laufzeit zurückgegebenen Ausführungsergebnisses zurückgegeben werden soll.

• Geben Sie die Transaktionsoption für den Ereignishandler an.

• Geben Sie den Protokollierungsmodus für den Ereignishandler an.