Lektion 3.2: Hinzufügen und Konfigurieren der ProtokollierungLesson 3-2: Add and configure logging

Anwendungsbereich:Applies to: JaSQL ServerSQL Server (alle unterstützten Versionen) yesSQL ServerSQL Server (all supported versions) Ja SSIS-Integrationslaufzeit in Azure Data FactorySSIS Integration Runtime in Azure Data Factoryyes SSIS-Integrationslaufzeit in Azure Data FactorySSIS Integration Runtime in Azure Data FactoryAnwendungsbereich:Applies to: JaSQL ServerSQL Server (alle unterstützten Versionen) yesSQL ServerSQL Server (all supported versions) Ja SSIS-Integrationslaufzeit in Azure Data FactorySSIS Integration Runtime in Azure Data Factoryyes SSIS-Integrationslaufzeit in Azure Data FactorySSIS Integration Runtime in Azure Data Factory

In dieser Aufgabe aktivieren Sie die Protokollierung für den Datenfluss im Paket „Lesson 3.dtsx“.In this task, you enable logging for the data flow in the Lesson 3.dtsx package. Anschließend konfigurieren Sie einen Protokollanbieter für Textdateien, um die Ereignisse „PipelineExecutionPlan“ und „PipelineExecuteTrees“ zu protokollieren.Then, you configure a Text File log provider to log the PipelineExecutionPlan and PipelineExecuteTrees events. Der Protokollanbieter für Textdateien erstellt Protokolle, die auf einfache Weise angezeigt werden können und portabel sind.The Text Files log provider creates logs that are easy to view and transport. Die Einfachheit dieser Protokolldateien ist während der grundlegenden Testphase eines Pakets nützlich.The simplicity of these log files makes these files useful during the basic testing phase of a package. Sie können die Protokolleinträge auch im Fenster Protokollereignisse des SSISSSIS-Designers anzeigen.You can also view the log entries in the Log Events window of SSISSSIS Designer.

Hinzufügen der Protokollierung zu einem PaketAdd logging to the package

  1. Klicken Sie im Menü SSIS auf Protokollierung.On the SSIS menu, select Logging.
    In Visual Studio 2019 befindet sich das Menü SSIS unter Erweiterungen > SSIS.In Visual Studio 2019, the SSIS menu is located under Extensions -> SSIS. Stellen Sie sicher, dass die Registerkarte Datenfluss ausgewählt ist und nicht Ablaufsteuerung.Make sure you have the Data Flow tab selected and not Control Flow

  2. Achten Sie darauf, dass im Dialogfeld Configure SSIS Logs (SSIS-Protokolle konfigurieren) innerhalb des Bereichs Container das oberste Objekt ausgewählt ist.In the Configure SSIS Logs dialog, in the Containers pane, make sure the topmost object is selected. Dieses Objekt stellt das Paket aus Lektion 3 dar.This object represents the Lesson 3 package.

  3. Wählen Sie auf der Registerkarte Anbieter und Protokolle im Feld Anbietertyp die Option SSIS-Protokollanbieter für Textdateien aus, und klicken Sie anschließend auf Hinzufügen.On the Providers and Logs tab, in the Provider type box, select SSIS log provider for Text files, and then select Add.

    Von Integration Services wird ein neuer Protokollanbieter für Textdateien mit dem Standardnamen SSIS-Protokollanbieter für Textdateien dem Paket hinzugefügt.Integration Services adds a new Text File log provider to the package, with the default name SSIS log provider for text files. Sie können jetzt den neuen Protokollanbieter konfigurieren.You can now configure the new log provider.

  4. Geben Sie in der Spalte Name die Zeichenfolge Protokolldatei für Lektion 3 ein.In the Name column, enter Lesson 3 Log File.

  5. Ändern Sie optional Beschreibung.Optionally, modify the Description.

  6. Klicken Sie in der Spalte Konfiguration auf <New Connection> , um anzugeben, wohin Integration ServicesIntegration Services die Protokollinformationen schreibt.In the Configuration column, select <New Connection> to specify where Integration ServicesIntegration Services writes log information.

    Wählen Sie im Dialogfeld Dateiverbindungs-Manager-Editor für Verwendungstyp die Option Datei erstellen aus, und klicken Sie anschließend auf Durchsuchen.In the File Connection Manager Editor dialog box, for Usage type, select Create file, and then select Browse. Standardmäßig wird vom Dialogfeld Datei auswählen der Projektordner geöffnet, aber Sie können Protokollinformationen an beliebigen Speicherorten speichern.By default, the Select File dialog opens the project folder, but you can save log information to any location.

  7. Geben Sie im Dialogfeld Datei auswählen innerhalb des Felds Dateiname den Namen Tutorialprotokoll.log, und klicken Sie auf Öffnen.In the Select File dialog, in the File name box enter TutorialLog.log and select Open.

  8. Klicken Sie auf OK, um das Dialogfeld Dateiverbindungs-Manager-Editor zu schließen.Select OK to close the File Connection Manager Editor dialog.

  9. Erweitern Sie im Container -Bereich alle Knoten der Paketcontainerhierarchie, und deaktivieren Sie anschließend alle Kontrollkästchen, einschließlich des Kontrollkästchens für Extract Sample Currency Data .In the Containers pane, expand all nodes of the package container hierarchy, and then clear all check boxes, including the Extract Sample Currency Data check box. Aktivieren Sie jetzt das Kontrollkästchen für Extract Sample Currency Data , um nur die Ereignisse für diesen Knoten abzurufen.Now select the check box for Extract Sample Currency Data to get only the events for this node.

    Hinweis

    Wenn der Status des Kontrollkästchens Extract Sample Currency Data abgeblendet anstatt ausgewählt ist, verwendet die Aufgabe die Protokolleinstellungen des übergeordneten Containers. In diesem Fall können Sie die aufgabenspezifischen Protokollereignisse nicht aktivieren.If the state of the Extract Sample Currency Data check box appears dimmed instead of selected, the task uses the log settings of the parent container and you cannot enable the log events that are specific to the task. Deaktivieren Sie das übergeordnete Kontrollkästchen, um das Problem zu beheben.To resolve this instance, clear the parent check box.

  10. Wählen Sie auf der Registerkarte Details in der Spalte Ereignisse die Ereignisse PipelineExecutionPlan und PipelineExecutionTrees aus.On the Details tab, in the Events column, select the PipelineExecutionPlan and PipelineExecutionTrees events.

  11. Klicken Sie auf Erweitert, um sich die Details anzusehen, die der Protokollanbieter für jedes Ereignis in das Protokoll schreibt.Select Advanced to review the details that the log provider writes to the log for each event. Standardmäßig werden alle Informationskategorien für die Ereignisse ausgewählt, die Sie angeben.By default, all information categories are automatically selected for the events you specify.

  12. Klicken Sie auf Basic (Einfach), um die Informationskategorien auszublenden.Select Basic to hide the information categories.

  13. Wählen Sie auf der Registerkarte Anbieter und Protokolle in der Name -Spalte Lesson 3 Log File aus.On the Provider and Logs tab, in the Name column, select Lesson 3 Log File. Nach dem Erstellen eines Protokollanbieters für Ihr Paket können Sie diesen optional deaktivieren, um die Protokollierung zu deaktivieren, ohne dass Sie einen Protokollanbieter löschen und dann neu erstellen müssen.After you have created a log provider for your package, you can optionally deselect it to turn off logging, without having to delete and re-create a log provider.

  14. Klicken Sie auf OK.Select OK.

Weiter zur nächsten AufgabeGo to next task

Schritt 3: Testen des Tutorialpakets aus Lektion 3Step 3: Test the Lesson 3 package