DB Connector

• Aufgabentyp: db

Der Task DB Connector ermöglicht die Ausführung von SQL-Anweisungen auf einer unterstützten Datenbank, sowohl zur Datenextraktion – mit der Möglichkeit, Ergebnisse auf spezifische Aliase abzubilden – als auch zur Ausführung von prozeduralem Code. Die Konfiguration erfordert die Definition der Datenbankverbindung und der zu auszuführenden SQL-Abfrage, die dem Zweck dient, Informationen abzurufen oder Operationen durchzuführen.

Datenbankverbindung

Parameter	Beschreibung
Datenbanktyp	Der zu verbindende Datenbanktyp (DBMS)
SSL-Verbindung	Aktiviert/Deaktiviert
Host	host o #>parametro_string<#
Port	port o #>parametro_num<#
DB-Name	nome_database o #>parametro_string<#
Benutzer	nome_utente o #>parametro_string<#
Passwort	Anmelde-Passwort

Statement-Konfiguration

Statement-Typ

• Select: Führt SQL-Abfragen zur Datenextraktion aus der Datenbank aus.
• Andere (Other): Ermöglicht die Ausführung von DML-Anweisungen (INSERT, UPDATE, DELETE), Aufrufen von Prozeduren/Stored Procedures oder anonymen SQL-Blöcken.

Beispiel für die SQL-Abfrage-Vorschau (Statement Preview)

Die Vorschau speichert die aktuelle Konfiguration, bevor die Abfrage ausgeführt wird, und begrenzt die angezeigten Zeilen. Sie ist auch mit SAP HANA verfügbar. Im Fehlerfall wird ein Diagnosecode angezeigt, der hilfreich ist, um Unterstützung zu beantragen.

SELECT
config->>'kid' AS kid,
config->>'iss' AS iss,
config->>'scope' AS scope,
config->>'grant_type' AS grant_type,
config->>'project_id' AS project_id,
replace(config->>'key', chr(10), '\n') AS key,
config->>'aud' AS aud
FROM connections
WHERE id=1;

Beispiel für die Abbildung der extrahierten Felder

Typ	Präzision	Alias	Ausdruck
EXPRESSION	1000	kid	config->>'kid'
EXPRESSION	1000	iss	config->>'iss'
EXPRESSION	1000	scope	config->>'scope'
EXPRESSION	1000	grant_type	config->>'grant_type'
EXPRESSION	1000	project_id	config->>'project_id'
EXPRESSION	2000	key	replace(config->>'key', chr(10), '\n')
EXPRESSION	1000	aud	config->>'aud'

Beispiel für die FROM-Klausel

FROM connections
WHERE id=1;

Verwendung eines dynamischen Parameters mit "dbobj:"

FROM `#>dbobj:nome_tabella<#` 

Verwaltung der Tabellenstruktur - Felder in der Select-Liste

Unten rechts in der Zuordningstabelle unter „Select-Typ Statement“ - „Felder in der Select-Liste“ befinden sich drei Schaltflächen:

Schaltfläche	Aktion
Speichern	Speichert die definierte Struktur
Importieren	Importiert eine vorhandene Struktur
Exportieren	Exportiert die definierte Struktur

Diese Funktion ermöglicht es, Zuordnungen zu speichern, zu exportieren oder wiederzuverwenden, wodurch die manuelle Kompilierung von Feldern vermieden und das Fehlerrisiko reduziert wird.

Technischer Hinweis

• Sichtbarkeit: In das System gespeicherte Strukturen sind nur für den erstellenden Benutzer sichtbar.
• Vertiefung: Für eine detaillierte Beschreibung aller Optionen und der Funktionslogik verweisen Sie auf die Seite Tabellenstruktur.

Ausgabe-Parameter

Nach Abschluss der Ausführung einer Abfrage gibt das Task "DB Connector" einen Satz von Ausgabe-Parameter zurück. Diese Parameter liefern nicht nur einen Bericht über die Operation, sondern auch die abgerufenen Daten in mehreren Formaten, bereit für die Verwendung durch nachfolgende Tasks.

Parameter bezogen auf das Abfrage-Spool

• queryspool.file: Gibt den vollständigen Pfad der generierten Spool-Datei zurück (eine CSV-Datei).
• queryspool.filename: Gibt nur den Namen der Spool-Datei zurück.
• queryspool.content: Enthält den gesamten Textinhalt der Spool-Datei.

Parameter zur Ausführungszusammenfassung

• count: Gibt die Gesamtzahl der Zeilen (Datensätze) an, die von der Abfrage zurückgegeben wurden.
• result: Gibt den allgemeinen Status der Task-Ausführung zurück (z. B. "Statement erfolgreich ausgeführt" oder eine Datenbankfehlermeldung).
• resultJson: Stellt das Ergebnis der Task-Ausführung im JSON-Format dar und enthält allgemeine Informationen, Konfigurationen und Details zur Ausführung.

Parameter zum Datenexport

Diese Parameter enthalten den gesamten abgerufenen Datensatz, bereits in verschiedenen Standards formatiert.

• DataExportCsv: Gibt den vollständigen Datensatz zurück, formatiert als Text im CSV-Format, einschließlich der Kopfzeile mit den Spaltennamen.
• DataExportNoHeaderCsv: Gibt den Datensatz im CSV-Format zurück, jedoch ohne die Kopfzeile. Dies ist nützlich, wenn nur die Rohdaten benötigt werden.
• DataExportJson: Gibt den vollständigen Datensatz zurück, formatiert als JSON-String (ein Array von Objekten, wobei jedes Objekt eine Zeile darstellt).

Objektparameter für erweiterte Verarbeitung

Diese Parameter stellen die Daten als strukturierte Objekte dar und sind ideal für die Interaktion mit anderen Tasks.

• Dataset: Dieser Parameter repräsentiert den Namen der Spalte der Tabelle (z. B.: name). Dies ist der wichtigste Parameter, um diesen Task mit einem Iterator zu verknüpfen. Um auf die Werte einer bestimmten Spalte während einer Iteration zuzugreifen, wird die Syntax Dataset.Spaltenname verwendet.
• DataColumn: Dieser Parameter ermöglicht den Zugriff auf den gesamten Inhalt einer Spalte als einzelne Einheit).
• DataColumn.Spaltenname: Gibt alle Werte der Spalte „Spaltenname“ zurück. Z. B.: „Luca, Maria, Giovanni, Elena“

Wichtige Hinweise

• Um dynamische Parameter im Abschnitt FROM und Statement zu verwenden, muss die folgende Syntax verwendet werden: "#>dbobj:parametro_dinamico<#" (mit Ausnahme des Datenbanktyps SAP HANA, in diesem Fall ist die übliche Syntax "#>nome_tabella<#" zu verwenden)

Beispiel für den Parameter resultJson

{
  "run_info": {
    "status": "Completed",
    "run_result": "Success"
  },
  "output_parameters": {
    "exitStatus": "0"
  }
}