Freigeben über


Lektion 3.2: Hinzufügen und Konfigurieren der Protokollierung

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

In dieser Aufgabe aktivieren Sie die Protokollierung für den Datenfluss im Paket „Lesson 3.dtsx“. Anschließend konfigurieren Sie einen Protokollanbieter für Textdateien, um die Ereignisse „PipelineExecutionPlan“ und „PipelineExecuteTrees“ zu protokollieren. Der Protokollanbieter für Textdateien erstellt Protokolle, die auf einfache Weise angezeigt werden können und portabel sind. Die Einfachheit dieser Protokolldateien ist während der grundlegenden Testphase eines Pakets nützlich. Sie können die Protokolleinträge auch im Fenster Protokollereignisse des SSIS-Designers anzeigen.

Hinzufügen der Protokollierung zu einem Paket

  1. Klicken Sie im Menü SSIS auf Protokollierung.
    In Visual Studio 2019 befindet sich das Menü SSIS unter „Erweiterungen > SSIS“. Stellen Sie sicher, dass die Registerkarte Datenfluss ausgewählt ist und nicht Ablaufsteuerung.

  2. Achten Sie darauf, dass im Dialogfeld Configure SSIS Logs (SSIS-Protokolle konfigurieren) innerhalb des Bereichs Container das oberste Objekt ausgewählt ist. Dieses Objekt stellt das Paket aus Lektion 3 dar.

  3. Wählen Sie auf der Registerkarte Anbieter und Protokolle im Feld Anbietertyp die Option SSIS-Protokollanbieter für Textdateienaus, und klicken Sie anschließend auf Hinzufügen.

    Von Integration Services wird ein neuer Protokollanbieter für Textdateien mit dem Standardnamen SSIS-Protokollanbieter für Textdateien dem Paket hinzugefügt. Sie können jetzt den neuen Protokollanbieter konfigurieren.

  4. Geben Sie in der Spalte Name die Zeichenfolge Protokolldatei für Lektion 3 ein.

  5. Ändern Sie optional Beschreibung.

  6. Klicken Sie in der Spalte Konfiguration auf <Neue Verbindung>, um anzugeben, wohin die Protokollinformationen von Integration Services geschrieben werden.

    Wählen Sie im Dialogfeld Dateiverbindungs-Manager-Editor für Verwendungstyp die Option Datei erstellen aus, und klicken Sie anschließend auf Durchsuchen. Standardmäßig wird vom Dialogfeld Datei auswählen der Projektordner geöffnet, aber Sie können Protokollinformationen an beliebigen Speicherorten speichern.

  7. Geben Sie im Dialogfeld Datei auswählen innerhalb des Felds Dateiname den Namen Tutorialprotokoll.log, und klicken Sie auf Öffnen.

  8. Klicken Sie auf OK, um das Dialogfeld Dateiverbindungs-Manager-Editor zu schließen.

  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 . Aktivieren Sie jetzt das Kontrollkästchen für Extract Sample Currency Data , um nur die Ereignisse für diesen Knoten abzurufen.

    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. Deaktivieren Sie das übergeordnete Kontrollkästchen, um das Problem zu beheben.

  10. Wählen Sie auf der Registerkarte Details in der Spalte Ereignisse die Ereignisse PipelineExecutionPlan und PipelineExecutionTrees aus.

  11. Klicken Sie auf Erweitert, um sich die Details anzusehen, die der Protokollanbieter für jedes Ereignis in das Protokoll schreibt. Standardmäßig werden alle Informationskategorien für die Ereignisse ausgewählt, die Sie angeben.

  12. Klicken Sie auf Basic (Einfach), um die Informationskategorien auszublenden.

  13. Wählen Sie auf der Registerkarte Anbieter und Protokolle in der Name -Spalte Lesson 3 Log Fileaus. 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.

  14. Klicken Sie auf OK.

Weiter zur nächsten Aufgabe

Schritt 3: Testen des Tutorialpakets aus Lektion 3