DB Connector

• Task Type: db

Le tâche DB Connector permet de réaliser des instructions SQL sur une base de données supportée, que ce soit pour l’extraction de données — avec possibilité de mapper les résultats sur des alias spécifiques — que pour l’exécution de code procédural. La configuration requiert la définition de la connexion à la base de données et de la requête SQL à exécuter, finalisée au recouvrement d’informations ou à l’exécution d’opérations.

Connexion à la Base de Données

Paramètre	Description
Type de Base de Données	Le type de base de données (DBMS) à laquelle se connecter
Connexion SSL	Activée/Désactivée
Hôte	hôte ou #>paramètre_string<#
Port	port ou #>paramètre_num<#
Nom de la Base de Données	nom_base de données ou #>paramètre_string<#
Utilisateur	nom_utilisateur ou #>paramètre_string<#
Mot de Passe	Mot de passe d’accès

Configuration de l’Instruction

Type d’Instruction

• Select: exécute des requêtes SQL pour l’extraction de données à partir de la base de données.
• Autre (Other): permet l’exécution d’instructions DML (INSERT, UPDATE, DELETE), d’appels à des procédures/stockées ou de blocs SQL anonymes.

Exemple de Prévisualisation de la Requête SQL (Statement Preview)

La prévisualisation sauvegarde la configuration actuelle avant d’exécuter la requête et limite le nombre de lignes affichées. Elle est également disponible avec SAP HANA. En cas d’erreur, un code de diagnostic est affiché pour faciliter la demande d’assistance.

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;

Exemple de Cartographie des Champs Extraits

Type	Précision	Alias	Expression
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'

Exemple de Clause From

FROM connections
WHERE id=1;

Utilisation du paramètre dynamique avec "dbobj:"

FROM `#>dbobj:nome_tabella<#` 

Gestion de la Structure de la Table - Champs de liste de sélection

En bas à droite de la table de mappage dans la “Type d’Instruction Select” - “Champs de liste de sélection” sont présents trois boutons :

Bouton	Action
Sauvegarder	Sauvegarde la structure définie
Importer	Importe une structure existante
Exporter	Exporte la structure définie

Cette fonctionnalité permet de sauvegarder, d’exporter ou de réutiliser les mappages, évitant la compilation manuelle des champs et réduisant le risque d’erreurs.

Note Technique

• Visibilité: Les structures sauvegardées dans le système sont visibles exclusivement par l’utilisateur qui les a créées.
• Approfondissement: Pour une description détaillée de toutes les options et de la logique de fonctionnement, faire référence à la page Structure de la table.

Paramètres de Sortie

Al termine de l'exécution d'une requête, la tâche "DB Connector" expose un ensemble de paramètres de sortie. Ces paramètres fournissent non seulement un compte rendu de l'opération, mais aussi les données récupérées dans de multiples formats, prêts à être utilisés par les tâches suivantes.

Paramètres Relatifs au Pool de Requête

• queryspool.file: Retourne le chemin complet du fichier de spool généré (un fichier CSV).
• queryspool.filename: Retourne uniquement le nom du fichier de spool.
• queryspool.content: Contient l'ensemble du contenu textuel du fichier de spool.

Paramètres de Résumé de l'Exécution

• count: Indique le nombre total de lignes (enregistrements) retournées par la requête.
• result: Fournit l'état global de l'exécution de la tâche (par exemple, "Statement exécuté avec succès" ou un message d'erreur de la base de données).
• resultJson: représente le résultat de l’exécution de la tâche en format JSON, incluant des informations générales, des configurations et des détails sur l’exécution.

Paramètres d'Exportation de Données

Ces paramètres contiennent l'ensemble des données récupérées, déjà formatées selon différents standards.

• DataExportCsv: Retourne l'ensemble des données, formaté comme texte au format CSV, y compris la ligne d'en-tête avec les noms des colonnes.
• DataExportNoHeaderCsv: Retourne l'ensemble des données au format CSV, mais sans la ligne d'en-tête. Il est utile lorsque l'on a besoin uniquement des données brutes.
• DataExportJson: Retourne l'ensemble des données, formaté comme une chaîne JSON (un tableau d'objets, où chaque objet représente une ligne).

Paramètres Objet pour un Traitement Avancé

Ces paramètres représentent les données sous forme d'objets structurés, idéaux pour l'interaction avec d'autres tâches.

• Dataset: Ce paramètre représente le nom de la colonne de la table (par exemple : name). Il s'agit du paramètre le plus important pour connecter cette tâche à un Itérateur. Pour accéder aux valeurs d'une colonne spécifique lors d'une itération, on utilise la syntaxe Dataset.NomColonne.
• DataColumn: Ce paramètre permet d'accéder à l'ensemble du contenu d'une colonne en tant qu'entité unique).
• DataColumn.NomColonne: Retourne tous les valeurs de la colonne “NomColonne”. Par exemple : “Luca, Maria, Giovanni, Elena”

Notes importantes

• Pour utiliser les paramètres dynamiques dans la section de la Clause FROM et Statement, on utilise la syntaxe suivante : "#>dbobj:parametro_dinamico<#" (à l'exception du Type de Base de Données SAP HANA, dans ce cas, on utilise la syntaxe habituelle "#>nom_table<#")

Exemple du paramètre resultJson

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