Debuggen der Ablaufsteuerung
Business Intelligence Development Studio und Microsoft Integration Services enthalten Funktionen und Tools, mit denen Sie die Ablaufsteuerung in einem Integration Services-Paket behandeln können.
Integration Services unterstützt Haltepunkte für Container und Tasks.
SSIS-Designer stellt zur Laufzeit Fortschrittsberichte bereit.
Business Intelligence Development Studio stellt Debugfenster bereit.
Haltepunkte
Der SSIS-Designer stellt das Dialogfeld Haltepunkte festlegen bereit, in dem Sie Haltepunkte festlegen können. Hierzu aktivieren Sie Unterbrechungsbedingungen und geben an, wie häufig ein Haltepunkt auftreten kann, bevor die Ausführung des Pakets angehalten wird. Haltepunkte können auf Paketebene oder auf der Ebene der einzelnen Komponenten aktiviert werden. Falls Unterbrechungsbedingungen auf der Task- oder Containerebene aktiviert sind, wird das Haltepunktsymbol neben dem Task oder Container auf der Entwurfsoberfläche der Registerkarte Ablaufsteuerung angezeigt. Falls die Unterbrechungsbedingungen im Paket aktiviert sind, wird das Haltepunktsymbol in der Bezeichnung der Registerkarte Ablaufsteuerung angezeigt.
Wird ein Haltepunkt erreicht, ändert sich das Haltepunktsymbol, damit Sie die Quelle des Haltepunktes identifizieren können. Sie können beim Ausführen des Pakets Haltepunkte hinzufügen, löschen und ändern.
Integration Services stellt zehn Unterbrechungsbedingungen bereit, die Sie für alle Tasks und Container aktivieren können. Im Dialogfeld Haltepunkte festlegen können Sie Haltepunkte für die folgenden Bedingungen aktivieren:
Unterbrechungsbedingung |
Beschreibung |
|---|---|
Wenn der Task oder Container das OnPreExecute-Ereignis empfängt. |
Wird aufgerufen, unmittelbar bevor ein Task ausgeführt wird. Dieses Ereignis wird durch einen Task oder Container ausgelöst, unmittelbar bevor er ausgeführt wird. |
Wenn der Task oder Container das OnPostExecute-Ereignis empfängt. |
Wird aufgerufen, unmittelbar nachdem die Ausführungslogik des Tasks beendet wurde. Dieses Ereignis wird durch einen Task oder Container ausgelöst, unmittelbar nachdem er ausgeführt wurde. |
Wenn der Task oder Container das OnError-Ereignis empfängt. |
Wird durch einen Task oder Container bei einem Fehler aufgerufen. |
Wenn der Task oder Container das OnWarning-Ereignis empfängt. |
Wird aufgerufen, wenn der Task einen Status aufweist, der keinen Fehler, aber eine Warnung rechtfertigt. |
Wenn der Task oder Container das OnInformation-Ereignis empfängt. |
Wird aufgerufen, wenn der Task Informationen bereitstellen muss. |
Wenn der Task oder Container das OnTaskFailed-Ereignis empfängt. |
Wird durch den Taskhost bei einem Fehler aufgerufen. |
Wenn der Task oder Container das OnProgress-Ereignis empfängt. |
Wird aufgerufen, um den Status der Taskausführung zu aktualisieren. |
Wenn der Task oder Container das OnQueryCancel-Ereignis empfängt. |
Wird zu einem beliebigen Zeitpunkt der Taskverarbeitung aufgerufen, wenn Sie die Ausführung abbrechen. |
Wenn der Task oder Container das OnVariableValueChanged-Ereignis empfängt. |
Wird durch die Integration Services-Laufzeit aufgerufen, wenn sich der Wert einer Variablen ändert. RaiseChangeEvent der Variablen muss auf true festgelegt werden, damit dieses Ereignis ausgelöst wird. |
Wenn der Task oder Container das OnCustomEvent-Ereignis empfängt. |
Wird durch Tasks aufgerufen, um benutzerdefinierte Taskereignisse auszulösen. |
Neben den Unterbrechungsbedingungen, die für alle Tasks und Container verfügbar sind, enthalten manche Tasks und Container spezielle Unterbrechungsbedingungen zum Festlegen von Haltepunkten. Beispielsweise können Sie eine Unterbrechungsbedingung für den For-Schleifencontainer aktivieren, um einen Haltepunkt festzulegen, der die Ausführung zu Beginn jeder Iteration der Schleife anhält.
Wenn Sie einen Haltepunkt flexibler und leistungsfähiger gestalten möchten, können Sie dessen Verhalten durch Angeben der folgenden Optionen ändern:
Die Trefferanzahl oder die Angabe, oder nach dem wievielten Auftreten einer Unterbrechungsbedingung die Ausführung angehalten wird.
Den Typ der Trefferanzahl oder die Regel, die angibt, wann die Unterbrechungsbedingung den Haltepunkt auslöst.
Die Typen der Trefferanzahl, mit Ausnahme des Typs Immer, werden durch die Trefferanzahl weiter definiert. Beispielsweise wird beim Typ "Trefferanzahl ist gleich" und der Trefferanzahl 5 die Ausführung angehalten, wenn die Unterbrechungsbedingung das sechste Mal auftritt.
In der folgenden Tabelle sind die Typen der Trefferanzahl aufgeführt.
Typ der Trefferanzahl |
Beschreibung |
|---|---|
Immer |
Die Ausführung wird immer angehalten, wenn der Haltepunkt erreicht wird. |
Trefferanzahl ist gleich |
Die Ausführung wird angehalten, wenn die Anzahl des Auftretens des Haltepunktes der Trefferanzahl entspricht. |
Trefferanzahl ist größer als oder gleich |
Die Ausführung wird angehalten, wenn die Anzahl des Auftretens des Haltepunktes mindestens so groß wie die Trefferanzahl ist. |
Trefferanzahl mehrfach |
Die Ausführung wird angehalten, wenn ein Mehrfaches der Trefferanzahl erreicht wird. Wenn Sie z. B. diese Option auf 5 festlegen, wird die Ausführung bei jedem fünften Mal angehalten. |
So legen Sie Haltepunkte fest
Fortschrittsberichte
Der SSIS-Designer enthält zwei Arten von Fortschrittsberichten: Farbcodierung auf der Entwurfsoberfläche der Registerkarte Ablaufsteuerung und Statusmeldungen auf der Registerkarte Status.
Wenn Sie ein Paket ausführen, wird der Ausführungsstatus im SSIS-Designer gekennzeichnet, indem jeder Task oder Container in einer Farbe angezeigt wird, die Ausschluss über den Ausführungsstatus gibt. Anhand der Farbe wissen Sie, ob das Element auf die Ausführung wartet, zurzeit ausgeführt wird, erfolgreich ausgeführt wurde oder nicht erfolgreich beendet wurde. Nachdem Sie die Paketausführung beendet haben, verschwindet die Farbcodierung.
In der folgenden Tabelle werden die Farben beschrieben, die zum Kennzeichnen des Ausführungsstatus verwendet werden.
Farbe |
Ausführungsstatus |
|---|---|
Grau |
Wartet auf die Ausführung |
Gelb |
Wird ausgeführt |
Grün |
Wurde erfolgreich ausgeführt |
Rot |
Wurde mit Fehlern ausgeführt |
Auf der Registerkarte Status werden Tasks und Container in der Ausführungsreihenfolge aufgeführt. Diese Registerkarte enthält außerdem die Start- und Beendigungszeiten, Warnungen und Fehlermeldungen. Wenn die Ausführung des Pakets beendet wurde, sind die Statusinformationen weiterhin auf der Registerkarte Ausführungsergebnisse verfügbar.
.gif "Hinweis") Hinweis |
|---|
Zum Aktivieren bzw. Deaktivieren der Anzeige von Meldungen auf der Registerkarte Status schalten Sie die Option Debug-Statusbericht im Menü SSIS um. |
Im folgenden Diagramm wird die Registerkarte Status angezeigt.
.gif "Status (Registerkarte) des SSIS-Designers")
Debugfenster
Business Intelligence Development Studio, eine Microsoft Visual Studio 2008-Entwicklungsumgebung, enthält viele Fenster, in denen Sie Haltepunkte verwenden und Pakete, die Haltepunkte enthalten, debuggen können. Um weitere Informationen zu den einzelnen Fenstern zu erhalten, öffnen Sie das entsprechende Fenster, und drücken Sie F1, um die zugehörige Hilfe anzuzeigen.
Zeigen Sie zum Öffnen dieser Fenster in Business Intelligence Development Studio im Menü Debuggen auf Fenster, und klicken Sie dann auf Haltepunkte, Ausgabe oder Direkt.
In der folgenden Tabelle sind diese Fenster beschrieben.
Fenster |
Beschreibung |
|---|---|
Haltepunkte |
Listet die Haltepunkte in einem Paket auf und stellt Optionen zum Aktivieren und Löschen von Haltepunkten bereit. |
Ausgabe |
Zeigt Statusmeldungen für Funktionen in Business Intelligence Development Studio an. |
Direkt |
Wird zum Debuggen und Auswerten von Ausdrücken und zum Drucken von Variablenwerten verwendet. |
|
.gif "Integration Services (kleines Symbol)")
Bleiben Sie mit Integration Services auf dem neuesten Stand