Benutzerdefinierte Meldungen für die Protokollierung

Neu: 05. Dezember 2005

Integration Services stellt einen umfangreichen Satz an benutzerdefinierten Ereignissen zum Schreiben von Protokolleinträgen für Pakete und für mehrere Tasks bereit. Sie können diese Einträge verwenden, um detaillierte Informationen zum Fortschritt sowie über die Ergebnisse und Probleme der Ausführung zu speichern, indem Sie vordefinierte Ereignisse bzw. benutzerdefinierte Meldungen für die spätere Analyse erfassen. Sie können beispielsweise Beginn und Ende eines Masseneinfügungsvorgangs erfassen, um Leistungsprobleme beim Ausführen des Pakets zu identifizieren.

Die benutzerdefinierten Protokolleinträge unterscheiden sich von den für Pakete und alle Container und Tasks verfügbaren Standardprotokollierungsereignissen. Die benutzerdefinierten Protokolleinträge dienen zum Erfassen nützlicher Informationen zu einem bestimmten Task eines Pakets. Beispielsweise zeichnet einer der benutzerdefinierten Protokolleinträge für den Task SQL ausführen die von dem Task ausgeführte SQL-Anweisung im Protokoll auf.

In allen Protokolleinträgen sind jeweils das Datum und die Uhrzeit enthalten, einschließlich der beim Beginnen und Beenden eines Pakets automatisch geschriebenen Protokolleinträge. Bei vielen Protokollereignissen werden mehrere Einträge in das Protokoll geschrieben. In der Regel tritt dies dann auf, wenn ein Ereignis verschiedene Phasen aufweist. Beispielsweise schreibt das ExecuteSQLExecutingQuery-Protokollereignis drei Einträge: einen Eintrag, nachdem der Task eine Verbindung mit der Datenbank erhalten hat; einen weiteren, nachdem der Task begonnen hat, die SQL-Anweisung vorzubereiten; und noch einen, nachdem die Ausführung der SQL-Anweisung abgeschlossen wurde.

Die folgenden Integration Services-Objekte verfügen über benutzerdefinierte Protokolleinträge:

Paket

Masseneinfügung (Task)

Datenfluss (Task)

DTS 2000 ausführen (Task)

Prozess ausführen (Task)

SQL ausführen (Task)

Dateisystem (Task)

FTP (Task)

Nachrichtenwarteschlange (Task)

Skript (Task)

Mail senden (Task)

Datenbanken übertragen (Task)

Fehlermeldungen übertragen (Task)

Aufträge übertragen (Task)

Anmeldungen übertragen (Task)

In master gespeicherte Prozeduren übertragen (Task)

SQL Server-Objekte kopieren (Task)

Webdienste (Task)

WMI-Datenleser (Task)

WMI-Ereignisüberwachung (Task)

XML (Task)

Protokolleinträge

Paket

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für Pakete aufgelistet.

Protokolleintrag

Beschreibung

PackageStart

Zeigt den Beginn der Paketausführung an.

Hinweis:

Dieser Protokolleintrag wird automatisch in das Protokoll geschrieben. Dieser Eintrag kann nicht ausgeschlossen werden.

PackageEnd

Zeigt den Abschluss der Paketausführung an.

Hinweis:

Dieser Protokolleintrag wird automatisch in das Protokoll geschrieben. Dieser Eintrag kann nicht ausgeschlossen werden.

Diagnostic

Enthält Informationen zur Systemkonfiguration, die sich auf die Paketausführung auswirken, z. B. die Anzahl gleichzeitig ausführbarer Dateien.

Seit Microsoft SQL Server 2005 Service Pack 2 (SP2) enthält der Protokolleintrag Diagnostic auch vorherige und nachfolgende Einträge für Aufrufe von externen Datenprovidern. Weitere Informationen finden Sie unter Paketausführung (Problembehandlung).

Masseneinfügung (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Masseneinfügungstask aufgelistet.

Protokolleintrag	Beschreibung
DTSBulkInsertTaskBegin	Zeigt den Beginn der Masseneinfügung an.
DTSBulkInsertTaskEnd	Zeigt die Fertigstellung der Masseneinfügung an.
DTSBulkInsertTaskInfos	Enthält beschreibende Informationen zum Task.

Datenfluss (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Datenflusstask aufgelistet.

Protokolleintrag	Beschreibung
BufferSizeTuning	Zeigt an, dass die Puffergröße durch den Datenflusstask geändert wurde. Im Protokolleintrag werden die Gründe für die Größenänderung beschrieben und die temporäre neue Puffergröße aufgelistet.
OnPipelinePostEndOfRowset	Zeigt an, dass das Signal für das Ende des Rowsets einer Komponente, das beim letzten Aufruf der ProcessInput-Methode festgelegt wird, ausgegeben wurde. Für jede Komponente wird jeweils ein Eintrag im Datenfluss geschrieben, in dem Eingaben verarbeitet werden. Der Eintrag schließt den Namen der Komponente ein.
OnPipelinePostPrimeOutput	Zeigt an, dass über die Komponente der letzte Aufruf der PrimeOutput-Methode abgeschlossen wurde. Je nach Datenfluss können mehrere Protokolleinträge geschrieben werden. Wenn es sich bei der Komponente um eine Quelle handelt, bedeutet das, dass die von der Komponente durchgeführte Zeilenverarbeitung fertig gestellt wurde.
OnPipelinePreEndOfRowset	Zeigt an, dass eine Komponente das Signal für das Ende des Rowsets, das beim letzten Aufruf der ProcessInput-Methode festgelegt wird, empfangen wird. Für jede Komponente wird jeweils ein Eintrag im Datenfluss geschrieben, in dem Eingaben verarbeitet werden. Der Eintrag schließt den Namen der Komponente ein.
OnPipelinePrePrimeOutput	Zeigt an, dass die Komponente den Aufruf von der PrimeOutput-Methode empfangen wird. Je nach Datenfluss können mehrere Protokolleinträge geschrieben werden.
OnPipelineRowsSent	Berichtet die beim Aufruf der ProcessInput-Methode für eine Komponenteneingabe bereitgestellte Zeilenanzahl. Der Protokolleintrag schließt den Komponentennamen ein.
PipelineBufferLeak	Enthält Informationen zu einer beliebigen Komponente, in der Puffer beibehalten wurden, nachdem der Puffermanager ausgeblieben ist. Das bedeutet, dass Pufferressourcen nicht freigegeben wurden, was zu Speicherverlusten führen kann. Der Protokolleintrag stellt den Namen der Komponente und die ID des Puffers bereit.
PipelineExecutionPlan	Berichtet den Ausführungsplan des Datenflusses. Es werden Informationen darüber bereitgestellt, wie Puffer an Komponenten gesendet werden. Diese Informationen in Verbindung mit dem PipelineExecutionTrees-Eintrag beschreiben, was in dem Task geschieht.
PipelineExecutionTrees	Berichtet die Ausführungsstruktur des Layouts im Datenfluss. Der Planer des Datenflussmoduls verwendet die Strukturen zum Erstellen des Datenflussplans.
PipelineInitialization	Enthält Initialisierungsinformationen über den Task. Diese Informationen schließen die für den temporären Speicher von BLOB-Daten zu verwendenden Verzeichnisse, die Standardpuffergröße und die in einem Puffer vorhandene Zeilenanzahl ein. Je nach Konfiguration des Datenflusstasks können mehrere Protokolleinträge geschrieben werden.

DTS 2000 ausführen (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Task DTS 2000 ausführen aufgelistet.

Protokolleintrag

Beschreibung

ExecuteDTS80PackageTaskBegin

Zeigt an, dass die Ausführung eines DTS 2000-Pakets über den Task gestartet wurde.

ExecuteDTS80PackageTaskEnd

Zeigt an, dass die Ausführung über den Task beendet wurde.

Hinweis:

Das DTS 2000-Paket kann nach Beendigung des Tasks mit der Ausführung fortfahren.

ExecuteDTS80PackageTaskTaskInfo

Enthält beschreibende Informationen zum Task.

ExecuteDTS80PackageTaskTaskResult

Berichtet das Ausführungsergebnis des durch den Task ausgeführten DTS 2000-Pakets.

Prozess ausführen (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Task Prozess ausführen aufgelistet.

Protokolleintrag	Beschreibung
ExecuteProcessExecutingProcess	Enthält Informationen zum Ausführprozess der zur Ausführung konfigurierten ausführbaren Datei. Es werden zwei Protokolleinträge geschrieben. Der eine Protokolleintrag enthält Informationen über den Namen und Speicherort der vom Task ausgeführten ausführbaren Datei, im anderen Eintrag wird das Beenden der ausführbaren Datei erfasst.
ExecuteProcessVariableRouting	Enthält Informationen darüber, welche Variablen an die Eingabe und an die Ausgaben der ausführbaren Datei geleitet werden. Es werden Protokolleinträge für stdin (für die Eingabe), für stdout (für die Ausgabe) und für stderr (für die Fehlerausgabe) geschrieben.

SQL ausführen (Task)

In der folgenden Tabelle wird der benutzerdefinierte Protokolleintrag für den Task SQL ausführen beschrieben.

Protokolleintrag	Beschreibung
ExecuteSQLExecutingQuery	Enthält Informationen zu den Ausführungsphasen der SQL-Anweisung. Protokolleinträge werden geschrieben, wenn der Task eine Verbindung mit der Datenbank erhält, wenn der Task beginnt, die SQL-Anweisung vorzubereiten, und nachdem die Ausführung der SQL-Anweisung abgeschlossen wurde. Der Protokolleintrag für die Vorbereitungsphase schließt die vom Task verwendete SQL-Anweisung ein.

Dateisystem (Task)

In der folgenden Tabelle wird der benutzerdefinierte Protokolleintrag für den Task Dateisystem beschrieben.

Protokolleintrag	Beschreibung
FileSystemOperation	Berichtet den vom Task durchgeführten Vorgang. Der Protokolleintrag wird geschrieben, wenn der Dateisystemvorgang gestartet wird, und enthält Informationen zur Quelle und zum Ziel.

FTP (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den FTP-Task aufgelistet.

Protokolleintrag	Beschreibung
FTPConnectingToServer	Zeigt an, dass mit dem Task eine Verbindung zum FTP-Server initiiert wurde.
FTPOperation	Berichtet den Beginn und Typ des vom Task ausgeführten FTP-Vorgangs.

Nachrichtenwarteschlange (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Task Nachrichtenwarteschlange aufgelistet.

Protokolleintrag	Beschreibung
MSMQAfterOpen	Zeigt an, dass das Öffnen der Warteschlange beendet wurde.
MSMQBeforeOpen	Zeigt an, dass das Öffnen der Warteschlange begonnen wurde.
MSMQBeginReceive	Zeigt an, dass das Empfangen einer Meldung begonnen wurde.
MSMQBeginSend	Zeigt an, dass das Senden einer Meldung begonnen wurde.
MSMQEndReceive	Zeigt an, dass das Empfangen einer Meldung beendet wurde.
MSMQEndSend	Zeigt an, dass das Senden einer Meldung beendet wurde.
MSMQTaskInfo	Enthält beschreibende Informationen zum Task.
MSMQTaskTimeOut	Zeigt an, dass beim Task ein Timeout eingetreten ist.

Skript (Task)

In der folgenden Tabelle wird der benutzerdefinierte Protokolleintrag für den Skripttask beschrieben.

Protokolleintrag	Beschreibung
ScriptTaskLogEntry	Berichtet die Ergebnisse der Implementierung der Protokollierung im Skript. Für jeden Aufruf der Log-Methode des Dts-Objekts wird jeweils ein Protokolleintrag geschrieben. Der Eintrag wird beim Ausführen des Codes geschrieben. Weitere Informationen finden Sie unter Logging in the Script Task.

Mail senden (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Task Mail senden aufgelistet.

Protokolleintrag	Beschreibung
SendMailTaskBegin	Zeigt an, dass das Senden einer E-Mail-Nachricht begonnen wurde.
SendMailTaskEnd	Zeigt an, dass das Senden einer E-Mail-Nachricht beendet wurde.
SendMailTaskInfo	Enthält beschreibende Informationen zum Task.

Datenbanken übertragen (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Task Datenbanken übertragen aufgelistet.

Protokolleintrag	Beschreibung
SourceDB	Gibt die vom Task kopierte Datenbank an.
SourceSQLServer	Gibt den Computer an, von dem die Datenbank kopiert wurde.

Fehlermeldungen übertragen (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Task Fehlermeldungen übertragen aufgelistet.

Protokolleintrag	Beschreibung
TransferErrorMessagesTaskFinishedTransferringObjects	Zeigt an, dass das Übertragen von Fehlermeldungen beendet wurde.
TransferErrorMessagesTaskStartTransferringObjects	Zeigt an, dass das Übertragen von Fehlermeldungen gestartet wurde.

Aufträge übertragen (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Task Aufträge übertragen aufgelistet.

Protokolleintrag	Beschreibung
TransferJobsTaskFinishedTransferringObjects	Zeigt an, dass das Übertragen von SQL Server-Agent-Aufträgen beendet wurde.
TransferJobsTaskStartTransferringObjects	Zeigt an, dass das Übertragen von SQL Server-Agent-Aufträgen gestartet wurde.

Anmeldungen übertragen (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Task Anmeldungen übertragen aufgelistet.

Protokolleintrag	Beschreibung
TransferLoginsTaskFinishedTransferringObjects	Zeigt an, dass das Übertragen von Anmeldungen beendet wurde.
TransferLoginsTaskStartTransferringObjects	Zeigt an, dass das Übertragen von Anmeldungen gestartet wurde.

In master gespeicherte Prozeduren übertragen (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Task In master gespeicherte Prozeduren übertragen aufgelistet.

Protokolleintrag	Beschreibung
TransferStoredProceduresTaskFinishedTransferringObjects	Zeigt an, dass das Übertragen von benutzerdefinierten gespeicherten Prozeduren, die in der master-Datenbank gespeichert sind, beendet wurde.
TransferStoredProceduresTaskStartTransferringObjects	Zeigt an, dass das Übertragen von benutzerdefinierten gespeicherten Prozeduren, die in der master-Datenbank gespeichert sind, gestartet wurde.

SQL Server-Objekte kopieren (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Task SQL Server-Objekte kopieren aufgelistet.

Protokolleintrag	Beschreibung
TransferSqlServerObjectsTaskFinishedTransferringObjects	Zeigt an, dass das Übertragen von SQL Server-Datenbankobjekten beendet wurde.
TransferSqlServerObjectsTaskStartTransferringObjects	Zeigt an, dass das Übertragen von SQL Server-Datenbankobjekten gestartet wurde.

Webdienste (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge aufgelistet, die für den Task Webdienste aktiviert werden können.

Protokolleintrag	Beschreibung
WSTaskBegin	Der Zugriff auf einen Webdienst wurde begonnen.
WSTaskEnd	Eine Webdienstmethode wurde beendet.
WSTaskInfo	Beschreibende Informationen zum Task.

WMI-Datenleser (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Task WMI-Datenleser aufgelistet.

Protokolleintrag	Beschreibung
WMIDataReaderGettingWMIData	Zeigt an, dass das Lesen der WMI-Daten begonnen wurde.
WMIDataReaderOperation	Berichtet die vom Task ausgeführte WQL-Abfrage.

WMI-Ereignisüberwachung (Task)

In der folgenden Tabelle werden die benutzerdefinierten Protokolleinträge für den Task WMI-Ereignisüberwachung aufgelistet.

Protokolleintrag	Beschreibung
WMIEventWatcherEventOccurred	Zeigt an, dass das vom Task überwachte Ereignis aufgetreten ist.
WMIEventWatcherTimedout	Zeigt an, dass beim Task ein Timeout eingetreten ist.
WMIEventWatcherWatchingForWMIEvents	Zeigt an, dass die Ausführung der WQL-Abfrage begonnen wurde. Der Eintrag schließt die Abfrage ein.

XML (Task)

In der folgenden Tabelle wird der benutzerdefinierte Protokolleintrag für den XML-Task beschrieben.

Protokolleintrag	Beschreibung
XMLOperation	Enthält Informationen über den vom Task durchgeführten Vorgang.

Siehe auch

Aufgaben

Implementieren der Protokollierung in Pakete

Konzepte

SQL Server Integration Services-Protokollanbieter

Hilfe und Informationen

Informationsquellen für SQL Server 2005