v26.03: Arbeiten mit Transformationsknoten

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

Verfügbare Datentypen

v26.03: Mapping Node

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

So konfigurieren Sie einen Mapping-Knoten:

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

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

3. Wählen Sie im rechten Bereich Mapping aus. Der Knoten wird auf der Arbeitsfläche angezeigt und das Konfigurations-Seitenpanel wird geöffnet.

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

   Parameter	Beschreibung
   Name	Eindeutige Kennung. Standardmäßig ist dies Mapping_[n].
   Eingabe	Wählen Sie einen vorgelagerten Read- oder SQL Script-Knoten aus.
   Schritte	Wählen Sie + Hinzufügen von Schritt, um Zuordnungen zu erstellen. Jeder Schritt erfordert Folgendes: Schrittname (Bezeichner) Mapping-Tabelle (die vordefinierte Mapping-Tabelle, die angewendet werden soll) Feld-Mapping (die zuzuordnenden Felder)
   v26.05:  Einstellungen (Optional)	Konfigurieren Sie die Knoten Vorhergehender und Nachfolgender, um die Ausführungsreihenfolge der Knoten zu steuern. Weitere Informationen finden Sie unter Arbeiten mit Knoteneinstellungen.

5. Wählen Sie Veröffentlichen in der Kopfzeile der Ebene 2, 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, sofern 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 bleiben leer, wenn die Option Fehler bei nicht zugeordneter Quelle nicht aktiviert ist.

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

v26.03: SQL Script Node

Der SQL Script-Knoten bietet Funktionen zur datenbasierten Transformation mittels SQL.

So konfigurieren Sie einen SQL Script-Knoten:

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

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

3. Wählen Sie SQL Script im rechten Bereich aus. Der Knoten wird auf der Arbeitsfläche angezeigt und das Konfigurations-Seitenpanel wird geöffnet.

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

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

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

6. Wählen Sie Veröffentlichen in der Kopfzeile der Ebene 2, 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, sofern 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, um die Syntax vor dem Veröffentlichen zu überprüfen.

Note: Knoten können 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 Eingabe-Knoten 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 Read-Knoten, Stammdaten oder Settings).

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 Script-Knoten die Sicherheitsrichtlinien auf Workspace-Ebene einhalten.