Debugger in Informatica: Haltepunkt- und ausführlicher Modus

⚡ Intelligente Zusammenfassung

Der Debugger in Informatica führt eine Map ausping Zeile für Zeile innerhalb des Designers, sodass der Wert, der nach jeder Transformation von jedem Port gehalten wird, sichtbar wird und nicht nur das Endergebnis, das auf das Ziel geschrieben wird.

  • 🧪 Sitzungsinstanz: Der Debugger benötigt eine bestehende Sitzung, eine wiederverwendbare Sitzung oder eine neue Debug-Sitzungsinstanz.
  • 🛡️ Target Sicherheit: Durch die Auswahl von „Zieldaten verwerfen“ bleibt die Zieltabelle unverändert, während die Karteping wird analysiert.
  • 🔎 Zwei Fenster: Das Zielfenster zeigt die einzufügende Zeile an; das Instanzfenster zeigt jeden Port einer ausgewählten Transformation an.
  • Ruderschrittping: Mit der Option „Nächste Instanz“ oder der Tastenkombination F10 wird der Debugger zeilenweise weitergeschaltet.
  • 🚩 Haltepunkte: Eine Bedingung wie ENAME gleich SCOTT stoppt den Lauf direkt bei der gewünschten Zeile.
  • 📝 TracNiveaustufen: Normal, Kurz, Ausführliche Initialisierung und Ausführliche Daten steuern, wie detailliert das Sitzungsprotokoll ist.

Debugger in Informatica

Wie wir in früheren Themen besprochen haben, ein Karteping Es handelt sich um eine Sammlung von Quell- und Zielobjekten, die durch eine Reihe von Transformationen miteinander verknüpft sind. Diese Transformationen bestehen aus einer Reihe von Regeln, die den Datenfluss und das Laden der Daten in die Ziele definieren.

Was ist Debugger?

Der Debugger ist ein sehr praktisches Hilfsprogramm in Informatica. Wenn wir die Map ausführenpingInformatica führt die Zuordnung ausping basierend auf der definierten Transformationslogik.

Die Ausführung ähnelt der Stapelverarbeitung, bei der wir weder die Zwischenergebnisse noch die Art und Weise der Datenmodifikation von Transformation zu Transformation sehen können.

Oftmals entsprechen die Daten im Zielsystem nicht unseren Erwartungen. Mithilfe des Debuggers können wir analysieren, wie sich die Daten innerhalb der Map bewegen.pingZeile für Zeile.

Der Debugger benötigt eine Sitzungsinstanz. Wir können entweder eine zuvor erstellte Sitzung wiederverwenden, um die Karte auszuführen.pingAlternativ können Sie eine neue Debug-Sitzungsinstanz erstellen. Da die Daten während des Debuggens von der Quelle abgerufen werden, legen wir fest, was mit diesen Daten geschieht.

  • Verwerfen Sie die Daten, oder
  • Laden Sie die Daten in das Zielsystem.

Diese Optionen können während der Konfiguration des Debuggers festgelegt werden.

Zur Überwachung des Debuggers gibt es im Informatica Designer zwei Fenster.

  • Target Fenster
  • Instanzfenster

Im Zielfenster wird der Zieldatensatz angezeigt, der in die Zieltabelle eingefügt werden soll. Im Instanzfenster können Sie eine beliebige Transformationsinstanz der Zuordnung auswählen.pingAlle Ports dieser Transformation sind dann in diesem Fenster sichtbar, sodass Sie analysieren können, wie die Daten transformiert werden.

Schritte zur Verwendung des Debuggers in einer Karteping

Der Informatica Designer bietet die Möglichkeit, den Debugger zum Debuggen von Zuordnungen zu verwenden.pingDas bedeutet, dass wir jede bestehende Karte debuggen und analysieren können.pingDie Voraussetzung für den Debugger ist, dass die Karteping sollte eine gültige Karte seinping.

In dieser Übung werden wir unsere bestehende Karte debuggen.ping Wir prüfen in der zuvor erstellten Zieldatenbank „m_emp_emp_target“ in unseren Quelldaten, ob ein bestimmter Datensatz mit dem Mitarbeiternamen „SCOTT“ vorhanden ist. Für Scott überprüfen wir, ob die Werte in Informatica abgerufen wurden und ob der Datensatz korrekt an das Zielsystem übertragen wurde.

Unsere Quelldaten für die Tabelle „emp“ sehen folgendermaßen aus.

Beispielhafte Zeilen der Mitarbeiter-Quelltabelle, einschließlich des in dieser Übung verwendeten SCOTT-Datensatzes

Für den Benutzernamen „SCOTT“ werden wir mithilfe des Debuggers überprüfen, welcher Wert für die Spalte „sal“ (Gehalt) in Informatica abgerufen wird.

Schritt 1) Öffnen Sie den Informatica Designer und öffnen Sie die Karte.ping Klicken Sie auf „m_emp_emp_target“. Dadurch werden die Quellqualifizierer- und Zieldefinitionstabellen mit der Zuordnung geöffnet.ping Karteping Designer.

Karteping m_emp_emp_target wurde in der Karte geöffnetping Designer mit seinem Quellqualifizierer und Ziel

Schritt 2) Starten Sie nun den Debugger.

  1. Klicken Sie auf die Kartepings Menüoption
  2. Wählen Sie Debugger aus den Optionen aus
  3. Wählen Sie die Option „Debugger starten“.

KartepingIm Designer ist das Menü mit den Optionen „Debugger“ und „Debugger starten“ ausgewählt.

Schritt 3) Wählen Sie „Weiter“ auf der Debug-Map aus.ping Fenster.

Startbildschirm der Debug-Karteping Assistent mit der Schaltfläche „Weiter“

Schritt 4) Im nächsten Fenster können Sie den Sitzungstyp auswählen. Sie können eine bestehende Sitzung, eine vorhandene wiederverwendbare Sitzung oder eine Debug-Sitzungsinstanz erstellen.

Wenn Sie eine bestehende Sitzung verwenden, nutzt Informatica die zuvor für diese Zuordnung erstellte Sitzung wieder.pingWenn Sie „Debug-Sitzungsinstanz erstellen“ auswählen, wird eine neue Sitzungsinstanz zum Debuggen erstellt.

In diesem Beispiel wählen wir eine bestehende Sitzungsinstanz aus. Der Integrationsdienst ist die Standardeinstellung.

  1. Wählen Sie die Option „Vorhandene Sitzungsinstanz verwenden“ aus.
  2. Klicken Sie auf Weiter

Sitzungstypbildschirm mit ausgewählter Option für die bestehende Sitzungsinstanz

Schritt 5) Im neuen Fenster werden Sie von Informatica aufgefordert, die vorhandene Sitzung für das Debuggen auszuwählen.

Wählen Sie die Sitzung „s_m_emp_emp_target“ aus und klicken Sie auf die Schaltfläche „Weiter“.

Assistent listet die wiederverwendbare Sitzung s_m_emp_emp_target zur Auswahl auf

Schritt 6) Im nächsten Fenster gibt es die Option „Zieldaten verwerfen“. Wir wählen diese Option, da wir während des Debuggens keine Daten in unsere Zieltabelle laden möchten.

  1. Wählen Sie die Option „Zieldaten verwerfen“.
  2. Wählen Sie die Zieltabelle „emp_target“ aus.
  3. Klicken Sie auf die Schaltfläche „Fertig stellen“.

Target Optionsbildschirm mit aktivierter Option „Zieldaten verwerfen“ für emp_target

Mit den obigen Schritten haben wir den Debugger konfiguriert und gestartet. Jetzt können wir die Karte debuggen.ping.

Schritt 7) Der Debugger ist gestartet, hat aber noch keine Zeilen aus der Quelle abgerufen. Während des Debuggens lädt er die Daten zeilenweise aus der Quelle. Um die erste Zeile aus der Quelle abzurufen, …

  1. Karte auswählenpingOption s aus dem Menü
  2. Wählen Sie die Option „Debugger“ aus.
  3. Wählen Sie die Option „Nächste Instanz“ aus.

KartepingDas Menü zeigt den Befehl „Nächste Instanz“ an, der eine Zeile abruft.

Schritt 8) Im Instanzfenster sehen Sie den ersten vom Quellqualifizierer abgerufenen Datensatz.

Instanzfenster, das die erste abgerufene Zeile für Mitarbeiter SMITH anzeigt

Wenn Sie das Instanzfenster analysieren, wird der erste Datensatz angezeigt – die Zeile mit dem Mitarbeiternamen „SMITH“. Dies ist nicht der gesuchte Datensatz, daher können wir zur nächsten Instanz wechseln.

Schritt 9) Um zur nächsten Zeile zu gelangen, drücken Sie die Taste F10. Dies ist die Abkürzung, um zur nächsten Instanz zu wechseln, anstatt die Karte zu verwenden.pingWählen Sie die Option „s“ und anschließend die Option „Debugger“.

Nach dem Wechsel zur nächsten Instanz werden die Daten im Instanzfenster auf den nächsten Datensatz aktualisiert.

Das Instanzfenster wurde nach dem Drücken von F10 mit der folgenden Quellzeile aktualisiert.

Schritt 10) Drücken Sie die Taste F10 so lange, bis Sie den gewünschten Datensatz des Mitarbeiters „SCOTT“ erreichen. Sobald Sie diesen Punkt erreicht haben, sieht das Instanzfenster wie unten dargestellt aus.

Das Instanzfenster blieb in der Zeile SCOTT mit Job, Manager-ID und Gehalt stehen.

Dies ist die Instanz, nach der wir gesucht haben. Im Instanzfenster können wir die Daten analysieren und prüfen, ob sie korrekt übermittelt werden oder ob Werte fehlen.

In den Quelldaten waren die Details des Mitarbeiters „SCOTT“: Job = „ANALYST“, Manager-ID = „7566“, Gehalt = „3000“.

Und im Debugger haben wir für den Mitarbeiter „SCOTT“ all diese Details analysiert, und sie stimmen mit den Quelldaten überein, sodass wir sicher sind, dass die Datensätze vom Source Qualifier korrekt abgerufen wurden.

Verwenden eines Haltepunkts im Debugger

Wenn wir wie im vorherigen Beispiel nach einer bestimmten Datenzeile suchen, können wir Haltepunkte definieren, anstatt zu jeder Instanz von Quelldaten zu gehen.

Ein Haltepunkt ist eine Bedingung oder eine Reihe von Bedingungen, die während der Konfiguration des Debuggings definiert werden, sodass der Debugger an der jeweiligen Stelle anhält, wenn diese Bedingung erfüllt ist.

Wenn wir beispielsweise in einem Haltepunkt deptno=20 definieren, dann hält der Debugger immer dann an, wenn diese Bedingung für einen Datensatz zutrifft.

Ein Haltepunkt kann auch für eine globale Bedingung anstatt für eine einzelne Transformation erstellt werden, und sein Typ kann auf Fehler anstatt auf Daten gesetzt werden, wodurch die Ausführung immer dann gestoppt wird, wenn diese Transformation einen Fehler auslöst.

Schritt 1) Um den Haltepunkt zu konfigurieren

  1. Zur Kartepings Menü
  2. Wählen Sie die Option „Debugger“ aus.
  3. Wählen Sie die Option „Haltepunkte bearbeiten“.

KartepingMenü mit dem Befehl "Haltepunkte bearbeiten" hervorgehoben

Schritt 2) Es wird ein Fenster mit der Bezeichnung „Haltepunkte bearbeiten“ angezeigt, wie unten dargestellt.

Das Fenster „Haltepunkte bearbeiten“ muss geöffnet sein, bevor Haltepunkte hinzugefügt wurden.

Schritt 3) Klicken Sie im Haltepunktfenster auf die Schaltfläche „Hinzufügen“.

Die Schaltfläche „Hinzufügen“ im Fenster „Haltepunkte bearbeiten“ dient zum Erstellen eines Haltepunkts.

Schritt 4) Im neuen Fenster

  1. Wählen Sie SQ_EMP als Instanz aus.
  2. Wählen Sie die Schaltfläche „OK“ aus.

Instanzauswahldialog mit SQ_EMP als Haltepunktinstanz ausgewählt

Schritt 5) Das vorherige Fenster sieht wie folgt aus.

Das Fenster „Haltepunkte bearbeiten“ listet den neuen Haltepunkt SQ_EMP auf.

Schritt 6) Sie haben einen Haltepunkt gesetzt und müssen nun die Haltepunktbedingung definieren. Klicken Sie dazu auf das Symbol „Neue Bedingung hinzufügen“.

Symbol „Neue Bedingung hinzufügen“ im Bedingungsreiter des Haltepunktfensters

Unter dem Reiter „Bedingung“ erscheint eine neue Zeile. Hier können wir die Bedingung konfigurieren.

Schritt 7) In der Konditionstabelle

  1. Wählen Sie im Dropdown-Menü „Port“ die Option „ENAME“ aus, da wir den Datensatz ename='SCOTT' debuggen.
  2. Geben Sie im Wertfeld den Wert „SCOTT“ ein.
  3. Wählen Sie die Schaltfläche „OK“ aus.

Die Bedingungszeile ist mit dem Port ENAME und dem Wert SCOTT konfiguriert.

Schritt 8) Starten Sie nun den Debugger wie im vorherigen Thema beschrieben.

Zur KartepingMenü s → Option Debugger auswählen → Debugger starten auswählen → Sitzungsinstanz auswählen.

Schritt 9) Sobald der Debugger gestartet ist

  1. Karte auswählenpings Menü
  2. Wählen Sie die Option „Debugger“ aus.
  3. Wählen Sie die Option „Weiter“.

KartepingDas Menü enthält den Befehl „Weiter“, der zum nächsten Haltepunkt führt.

Der Debugger durchläuft jede Zeile und prüft die Bedingung „ename=SCOTT“. Er hält bei dem Datensatz an, für den die Bedingung erfüllt ist. Bei großen Datenmengen ermöglicht ein Haltepunkt das direkte Springen zu diesem Datensatz anstatt Schritt für Schritt.ping durch jede Quellzeile.

Der Debugger hielt in der Zeile SCOTT an, nachdem die Haltepunktbedingung erfüllt war.

Sobald Informatica alle Instanzen durchlaufen hat, stoppt der Debugger automatisch. Um die Daten erneut zu analysieren, muss der Debugger neu gestartet werden.

Tracing in Informatica

Immer wenn Sie eine Sitzung für eine Karte ausführenpingEs wird ein Sitzungsprotokoll erstellt. Dieses enthält Details zur Ausführung, wie zum Beispiel

  • Zeitpunkt der Ereignisse
  • Fehlerdetails
  • Statistiken zur individuellen Transformation usw.

Im Inneren der Transformationen einer KartepingSie können konfigurieren, wie viele Details Informatica in das Sitzungsprotokoll schreibt.

Es gibt vier Stufen, die eingestellt werden können für tracinnerhalb der Transformationen.

TracNiveau Was Informatica in das Sitzungsprotokoll schreibt
Normal Im Normalmodus protokolliert Informatica die Initialisierung und den Status der Transformation, aufgetretene Fehler und fasst die Sitzungsergebnisse zusammen.
Rückwärts Im Terse-Modus protokolliert Informatica lediglich Initialisierungsinformationen und Fehlerdetails. Im Terse-Modus werden nur die minimal notwendigen Details in das Sitzungsprotokoll geschrieben.
Ausführliche Initialisierung Im Modus „Verbose Initialization“ schreibt Informatica die Protokolldetails ähnlich wie im Normalmodus und zusätzlich auch Informationen über die verwendeten Daten- und Indexdateien sowie Transformationsstatistiken.
Ausführliche Daten Im Modus „Verbose Data“ schreibt Informatica ein Protokoll, das dem Modus „Verbose Initialization“ ähnelt, protokolliert aber zusätzlich jede einzelne Datenzeile, die die Transformation durchläuft.

Verbose Data vermerkt auch, wo der Integrationsdienst Zeichenkettendaten kürzt, um sie an die Genauigkeit einer Spalte anzupassen.

Hinweis: Standardmäßig ist der tracDer Ausgabepegel ist auf Normal eingestellt. Es wird empfohlen, den Modus „Ausführliche Daten“ nur beim Debuggen der Karte zu verwenden.pingDer Kurzmodus kann zur Leistungsverbesserung genutzt werden, da er nur die minimal erforderlichen Details schreibt, sodass der Aufwand für das Schreiben des Protokolls minimal ist.

Wie einstellen TracEbene der Transformation

Schritt 1) Öffnen Sie die Karteping im Informatica Designer, für den Sie die Einstellungen vornehmen möchten tracing level.

Karteping in Informatica Designer geöffnet, bereit für eine tracÄnderung des Niveaus

Schritt 2) Double-Klicken Sie auf die Transformation, hier auf die Source Qualifier-Transformation „SQ_EMP“.

Dadurch wird das Fenster „Transformationen bearbeiten“ geöffnet.

Das Fenster „Transformationen bearbeiten“ wurde für den Quellqualifizierer SQ_EMP geöffnet.

Schritt 3) Im Fenster „Transformationen bearbeiten“

  1. Klicken Sie auf die Registerkarte Eigenschaften
  2. Wähle aus Tracing Level Option
  3. Wählen Sie im Dropdown-Menü „Ausführliche Daten“ aus.
  4. Wählen Sie die Schaltfläche „OK“ aus.

Registerkarte „Eigenschaften“ mit dem TracDie Dropdown-Liste „Ausführliche Daten“ ist auf „Verbose Daten“ eingestellt.

Schritt 4) Karte speichernping und die Karte ausführenpingVerwenden Sie die Tastenkombination Strg+S, um die Karte zu speichern.ping.

Schritt 5) Um das Protokoll anzuzeigen

  1. Öffne Workflow-Monitor und wählen Sie die Sitzung aus, die im letzten Schritt ausgeführt wurde
  2. Klicken Sie auf die Option „Sitzungsprotokoll“, um das Sitzungsprotokoll für die Karte zu öffnen.ping

Kontextmenü des Workflow-Monitors mit der Option „Sitzungsprotokoll“

Dadurch wird das Sitzungsprotokollfenster für die Karte geöffnet.ping.

Das Sitzungsprotokoll beschreibt detailliert den Ablauf Ihrer Sitzung: den Zeitpunkt des Starts und des Stopps der Ausführung, eine grundlegende Einschätzung der Leistung, welche Datenbankverbindung und Parameterdatei verwendet wurden sowie die Anzahl der abgerufenen Quelldatensätze und der in das Ziel geladenen Datensätze.

Sitzungsprotokoll-Header mit Auflistung von Zeitangaben, Verbindungen sowie Quell- und Zielanzahl

Schritt 6) Scrollen Sie im Protokoll nach unten, und Sie sehen weitere erfasste Protokolldetails, einschließlich der Datensätze.

Unterer Teil des Sitzungsprotokolls mit Anzeige der einzelnen Datensätze, die vom ausführlichen Modus erfasst wurden tracIng.

Auf diese Weise können Sie die tracEbene in der Kartepingum die zusätzlichen Details für die Fehlersuche zu erfassen.

In diesem Tutorial haben Sie gelernt, wie Sie den Debugger einrichten, konfigurieren und ausführen und wie Sie die Einstellungen vornehmen. tracEbene in der KartepingDiese Optionen ermöglichen es Ihnen, die Karte zu debuggen.pings.

Häufig gestellte Fragen

Die Karteping Die Angaben müssen zunächst gültig sein. Nicht verbundene Ports, eine defekte Verbindung oder ein ungültiger Ausdruck verhindern das Öffnen des Assistenten, sodass der Designer den Validierungsfehler und die Zuordnung meldet.ping muss korrigiert werden.

Die Datenvorschau zeigt die Rohdaten direkt aus der Quell- oder Zieltabelle an. Schrittping Es werden nach jedem Transformationslauf die gleichen Zeilen angezeigt, sodass ersichtlich wird, wo sich ein Wert ändert, und nicht, was die Tabelle enthält.

Es schreibt jede Zeile, die in die Karte gelangt.pingDadurch wächst das Protokoll schnell und der Lauf verlangsamt sich. Stellen Sie den Schwierigkeitsgrad wieder auf „Normal“ oder, für den geringsten Overhead, auf „Kurz“ ein, sobald das Problem gefunden wurde.

Nein. Sobald der Lauf beendet oder gestoppt wird, wird die Sitzung geschlossen und die Analyse ab der ersten Zeile neu gestartet. Eine Bedingung für den relevanten Wert vermeidet diesen Schritt.ping erneut durch die früheren Aufzeichnungen.

Tools zur Datenqualitätssicherung auf Basis von maschinellem Lernen erstellen Profile für jeden Durchlauf und kennzeichnen Spalten, deren Verteilung sich zwischen den Ladevorgängen ändert. Dies weist auf die Transformation hin, die den Wert vor jedem manuellen Schritt verändert hat.ping beginnt.

Copilot kann sich nicht mit dem Designer verbinden, aber es kann generieren Python oder Shell-Skripte, die ein ausführliches Protokoll analysieren, abgelehnte Zeilen nach Fehlercode zählen und Zeilendaten um einen Fehler herum extrahieren.

Informatica Intelligent Cloud Services bietet eine Datenvorschau für einzelne Transformationen sowie Protokolle auf Jobebene anstelle einer schrittweisen Debug-Sitzung, sodass die Zeilenprüfung in der Map erfolgt.ping Designer.

Der Integrationsdienst speichert die Protokolldatei auf dem Knoten, auf dem die Sitzung ausgeführt wurde, im konfigurierten Sitzungsprotokollverzeichnis. Beim Öffnen über den Monitor wird der Protokollagent aufgefordert, die Protokolldatei zu öffnen; ein Serverzugriff ist daher nicht erforderlich.

Fassen Sie diesen Beitrag mit folgenden Worten zusammen: