v26.03: Arbeiten mit Transformationsknoten

Transformationsknoten (früher „Berechnungsknoten“) wandeln Daten aus vorgelagerten Knoten mithilfe verschiedener Methoden um.

Verfügbare Datentypen

v26.03: Zuordnungsknoten

Der Mapping-Knoten transformiert Daten, indem er vordefinierte Mapping-Tabellen auf Eingabe-Datensätze anwendet.

So konfigurieren Sie einen Knoten der Zuordnung:

1. Klicken Sie in der Kopfzeile der Ebene 2 auf + Knoten hinzufügen. Das Dialogfeld Knoten hinzufügen wird geöffnet.

2. Wählen Sie Transformieren im linken Bereich aus.

3. Wählen Sie im rechten Bereich Zuordnung aus. Der Knoten wird auf dem Canvas angezeigt und das Konfigurations-Seitenpanel wird geöffnet.

4. Füllen Sie die erforderlichen Felder im Konfigurationsbereich aus:

   Parameter	Beschreibung
   Name	Eindeutige Kennung. Standardwert ist „Mapping_[n]“.
   Eingabe	Wählen Sie einen vorgelagerten Read-, Zuordnung- oder SQL Script-Knoten aus.
   Schritte	Wählen Sie + Hinzufügen von Schritt aus, um Zuordnungen zu erstellen. Für jeden Schritt ist Folgendes erforderlich: Schrittname (Bezeichner) Mapping-Tabelle (die vordefinierte Mapping-Tabelle, die angewendet werden soll) Feld-Mapping (die zuzuordnenden Felder)
   v26.10:  Nur erste Übereinstimmung	Wählen Sie diese Option aus, um nur die erste Zeile mit Übereinstimmung in der Reihenfolge der Zeilen zurückzugeben, wenn ein Wert mit mehr als einer Zeile der Mapping-Tabelle übereinstimmt. Wenn das Kontrollkästchen deaktiviert ist (Standardeinstellung), gibt der Knoten alle Zeilen mit Übereinstimmungen zurück. Die Einstellungen gelten für alle Schritte im Knoten.
   v26.05:  Einstellungen (Optional)	Konfigurieren Sie Vorhergehende Knoten und Nachfolgende Knoten, um die Ausführungsreihenfolge der Knoten zu steuern. Weitere Details finden Sie unter Arbeiten mit Knoteneinstellungen.

5. Wählen Sie Veröffentlichen in der Kopfzeile der Ebene 2 aus, um die Konfiguration zu speichern.

   Nach dem Veröffentlichen sind in der Kopfzeile der Ebene 2 die folgenden Steuerelemente verfügbar:

   • Aktualisieren: Lädt das Raster neu, um Änderungen zu übernehmen.

   • Ausführen: Führt die Abfrage aus, wenn sie gültig ist.

Wechseln Sie zur Registerkarte „Ausführungsausgabe“, um eine Vorschau der Daten der Mapping-Tabelle anzuzeigen. Die Registerkarte „Ausführungsausgabe“ zeigt außerdem eine Echtzeit-Vorschau der Datensimulation an: Zuordnungszeilen zeigen den zugeordneten Wert an, fehlgeschlagene Zeilen zeigen „N/A“ an, und nicht zugeordnete Zeilen sind leer, wenn „Bei nicht zugeordneter Quelle fehlgeschlagen“ nicht aktiviert ist.

v26.04: Benutzer können Schritte über das Ellipsenmenü neu anordnen, bearbeiten und löschen. Die Behandlung nicht zugeordneter Werte übernimmt die Einstellung „Fail on Unmapped Source“ aus der ausgewählten Mapping-Tabelle.

v26.10: Wenn ein Lauf mit nicht zugeordneten Werten gestoppt wird oder endet, listet die Registerkarte „Meldung“ der Ausführungsausgabe die Anzahl der abgelehnten Datensätze und die nicht zugeordneten Werte nach Dimension auf. Zum Beispiel: 3 Datensätze wurden aufgrund der folgenden Dimension(en) abgelehnt: Masterdata: ["EM","AF","DC"]

v26.10: Quellwerte abgleichen und überspringen

Der Mapping-Knoten vergleicht jeden Wert der Quelle mit den Zeilen der Mapping-Tabelle in der Reihenfolge der Zeilen. Es gelten die folgenden Regeln:

v26.03: SQL-Skript-Knoten

Der SQL-Skript-Knoten bietet SQL-basierte Funktionen zur Datentransformation.

So konfigurieren Sie einen SQL-Skript-Knoten:

1. Klicken Sie in der Kopfzeile der Ebene 2 auf + Knoten hinzufügen. Das Dialogfeld Knoten hinzufügen wird geöffnet.

2. Wählen Sie Transformieren im linken Bereich aus.

3. Wählen Sie SQL-Skript im rechten Bereich aus. Der Knoten wird auf dem Canvas angezeigt und das Konfigurations-Seitenpanel wird geöffnet.

4. Füllen Sie die erforderlichen Felder im Konfigurationsbereich aus:

   Parameter	Beschreibung
   Name	Eindeutige Kennung. Die Standardbezeichnung lautet „SQL-Skript_[n]“.
   Eingabe	Wählen Sie + Hinzufügen aus, um vorgelagerte Knoten auszuwählen. Es werden mehrere Eingaben unterstützt.
   Abfrage	Geben Sie die SQL-Logik ein. Wählen Sie Erweitern aus, um die Erweiterte Ansicht zur Bearbeitung zu öffnen.
   v26.05:  Einstellungen (Optional)	Konfigurieren Sie Vorhergehende Knoten und Nachfolgende Knoten, um die Ausführungsreihenfolge der Knoten zu steuern. Weitere Details finden Sie unter Arbeiten mit Knoteneinstellungen.

5. (Optional) Auswählen Validieren, um die Syntax vor dem Veröffentlichen zu überprüfen.

6. Wählen Sie Veröffentlichen in der Kopfzeile der Ebene 2 aus, um die Konfiguration zu speichern.

   Note: Knoten können auch mit ungültigen Abfragen veröffentlicht werden – in diesem Fall wird eine Warnung angezeigt.

   Nach dem Veröffentlichen sind in der Kopfzeile der Ebene 2 zusätzliche Steuerelemente verfügbar:

   • Aktualisieren: Lädt das Raster neu, um Änderungen zu übernehmen.

   • Ausführen: Führt die Abfrage aus, wenn sie gültig ist.

Das Feld Abfrage unterstützt Folgendes:

• Abfragesyntax – {{node_name}} und ${dimension_description} mit Beispielen.

• Unterstützte SQL-Operationen – SELECT, JOIN, WHERE, GROUP BY, ORDER BY, Funktionen.

• Validierungsinformationen – Wählen Sie Validieren aus, um die Syntax vor dem Veröffentlichen zu überprüfen.

Note: Knoten können auch mit ungültigen Abfragen veröffentlicht werden (Warnung wird angezeigt)

v26.02: Die Abfrage wird beim Veröffentlichen oder Aktualisieren validiert. Das System zeigt eine Warnung an, wenn SQL-Abfragen auf nicht autorisierte Komponenten zugreifen.

v26.04: Abfragesyntax: Verwenden Sie {{node_name}} für Eingabeknoten und {{node_name}}.DIM_NAME für Dimensionen.

v26.08:  Eingabevalidierung und Sicherheit

SQL-Abfragen können nun nur noch auf Tabellen verweisen, die explizit als Eingabeknoten hinzugefügt wurden (über Leseknoten, Stammdaten oder Einstellungen).

Direkte Backend-Tabellen-IDs oder -Namen werden sowohl beim Speichern als auch bei der Ausführung blockiert.

Dadurch wird eine Lücke geschlossen, durch die Workflows die Datenzugriffskontrollen auf Workspace-Ebene umgehen konnten, und es wird sichergestellt, dass alle SQL-Skript-Knoten die Sicherheitsrichtlinien auf Workspace-Ebene einhalten.

v26.10:  Um diese Einschränkung für einen Workflow aufzuheben, wählen Sie Zugriff auf Workspace-Tabellen zulassen im Bereich „Workflow-Details“ aus. Die Option ist standardmäßig deaktiviert.

v26.09:  Standardisierung der SQL-Syntax

Der Knoten „SQL-Skript“ verwendet nun eine standardisierte Syntax für die Referenzierung von Knoten, Spalten und Parametern. Dies ersetzt die bisherigen Formen {{node_name}} und ${Node Name}.

Knoten- und Spalten-Referenzen

Spalten werden im Format 'node_id'.'column_id' referenziert, wobei sowohl die Knoten-ID als auch die Spalten-ID in einfache Anführungszeichen gesetzt werden.

• Eine Referenz muss immer sowohl die Knoten-ID als auch die ID der Spalte enthalten, getrennt durch einen Punkt. Eine Abfrage, die einen reinen Namen einer Spalte ohne Referenzen verwendet, wird mit einer eindeutigen Meldung abgelehnt.

• Eine in einfache Anführungszeichen gesetzte Knoten- oder Spalten-ID, die nicht zu einem deklarierten Eingabeknoten oder einer seiner Spalten aufgelöst werden kann, wird mit einer eindeutigen Fehlermeldung zurückgewiesen, die den unbekannten Bezeichner identifiziert.

• Einfache und doppelte Anführungszeichen werden nicht gemischt.

Die standardisierte Syntax gilt einheitlich für das Verfassen von Abfragen, das Anzeigen der Struktur der Eingabe- und Ausgabestruktur und die Vorschau der Daten. Die Strukturanzeige zeigt ID (Beschreibung) an, während die Abfrage 'node_id'.'column_id' verwendet.

Parameter-Referenzen

Auf alle Parameter wird im Format $'parameter_name' verwiesen. Die bisherige Form ${Node Name} wird nirgendwo mehr verwendet oder angezeigt.

Dies gilt für jeden Parameter im Bereich Verfügbare Parameter, einschließlich Systemparametern (Ausführungsdatum, Ausführungszeitraum, Ausführender Benutzer) und benutzerdefinierten Parametern.

Verhalten des Editors

• Ein Klick auf einen Parameter im Bereich Verfügbare Parameter fügt diesen an der Position des Cursors in der Syntax $'parameter_name' ein, anstatt ihn in die Zwischenablage zu kopieren.

• Während der Eingabe innerhalb von einfachen Anführungszeichen schlägt der Editor Übereinstimmungen für Eingabeknoten-IDs vor. Nach 'node_id'. schlägt er die ID-Werte der Spalten dieses Knotens vor, die ausschließlich aus den deklarierten Eingabeknoten des SQL-Knotens stammen. Durch Auswählen eines Vorschlags wird die vollständige Referenz 'node_id'.'column_id' eingefügt.

Auswirkungen auf bestehende Workflows

Bestehende Workflows werden nicht automatisch aktualisiert. Bestehende SQL-Abfragen, die in der bisherigen Syntax geschrieben wurden – unter Verwendung von {{node_name}}.column_name oder ${Node Name} – werden erst ausgeführt, wenn sie einer Aktualisierung der Syntax unterzogen wurden. Jeder Knoten, dessen Abfrage nicht mehr aufgelöst werden kann, wird als ungültig markiert.

Note: Bestehende Knoten behalten ihre aktuellen Namen und IDs bei. Durch diese Aktualisierung wird keine Tabelle neu erstellt und keine ID geändert.

v26.10:  Abfragefehler beheben

Wenn Sie einen SQL-Skript-Knoten Validieren, Veröffentlichen oder Ausführen, wird ein Problem in der Abfrage in der Ausgabe mit einer spezifischen Meldung gemeldet. Die Meldung verwendet die Namen, die auf dem Bildschirm angezeigt werden, z. B. die von Ihnen angegebenen Namen der Eingabeknoten, und gibt die Zeile und die Spalten des Problems in der Abfrage so an, wie Sie sie eingegeben haben.

Die folgenden Arten von Problemen werden gemeldet:

Fehler, die während der Ausführung der Abfrage auftreten, behalten ihren bestehenden Text bei, wobei Ihre Namen der Eingabeknoten anstelle der Namen der internen Tabellen stehen.

Note: Ein unzulässiges Schlüsselwort innerhalb eines Textwerts, eines Kommentars oder eines in Anführungszeichen gesetzten Bezeichners blockiert eine Abfrage nicht, und eine Abfrage kann mit einer eigenen LIMIT-Klausel enden.