SQL-DB Operations

Ce bloc de fonction vous permet d'effectuer des opérations SQL courantes (INSERT, QUERY, UPDATE, DELETE, EXECUTE) sur une base de données connectée. Il fournit une interface simple pour sélectionner l'opération souhaitée, saisir un nom de table si nécessaire et alimenter les entrées requises via des sockets. Les opérations s'exécutent en arrière-plan pour que l'interface reste réactive.

📥 Entrées (sockets)

Selon l'opération SQL sélectionnée, le bloc expose différents sockets d'entrée. Chaque nom listé ci‑dessous correspond à un socket que vous pouvez connecter à d'autres blocs.

Sockets communs à toutes les méthodes

• Enable Doit être mis à true pour exécuter l'opération sélectionnée.

• DB Client Référence du client de base de données fournie par un bloc de connexion séparé (voir Conseils et astuces).

Sockets par méthode

• INSERT

  • JSON Data Données à insérer dans la table sélectionnée (JSON/dictionnaire).

• QUERY

  • Query String Chaîne SQL SELECT ou autre requête à exécuter.

• UPDATE

  • JSON Data Valeurs de mise à jour (JSON/dictionnaire).

  • JSON Data(Where Conditions) Conditions WHERE pour sélectionner les lignes à mettre à jour.

• DELETE

  • JSON Data(Where Conditions) Conditions WHERE pour sélectionner les lignes à supprimer.

• EXECUTE

  • Statement String Instruction SQL brute à exécuter (à utiliser avec précaution).

Remarque : le bloc affichera ou masquera le contrôle d'entrée Table Name en fonction de l'opération choisie.

📤 Sorties (sockets)

• Output Data Retourne le résultat de l'opération (par exemple les lignes d'une requête, informations sur les lignes affectées, ou données spécifiques à l'opération).

• Success? Booléen indiquant si l'opération s'est terminée avec succès.

🕹️ Contrôles (widgets)

• Select SQL Operation Menu déroulant pour choisir parmi : INSERT / QUERY / UPDATE / DELETE / EXECUTE. Le changement met à jour les sockets d'entrée disponibles pour correspondre à l'opération choisie.

• Table Name Champ texte pour le nom de la table cible. Masqué automatiquement lorsque non requis (par exemple avec EXECUTE).

⚙️ Mécanisme d'exécution

• Le bloc ne s'exécute que lorsque le socket Enable reçoit la valeur true.

• Il nécessite un socket DB Client valide connecté (généralement fourni par un bloc de connexion à la base de données).

• Lorsqu'il est déclenché, le bloc exécute l'opération choisie en arrière-plan et renvoie Output Data et Success? une fois terminé.

• Tout problème (entrées invalides, client manquant, JSON mal formé ou erreurs SQL) est signalé dans la zone de messages/log du bloc.

✨ Fonctionnalités clés

• Sockets dynamiques qui s'adaptent à l'opération SQL choisie pour une interface propre.

• Exécution en arrière-plan pour garder l'interface réactive lors d'appels base de données longs.

• Entrées simples basées sur JSON pour INSERT et UPDATE afin de faciliter l'alimentation de données tabulaires.

• Indicateur clair de réussite et données de résultat retournées pour traitement ultérieur.

📝 Instructions d'utilisation

1. Fournissez un client de base de données au socket DB Client (voir Conseils et astuces).

2. Choisissez l'opération désirée avec Select SQL Operation.

3. Si nécessaire, saisissez la table cible dans Table Name.

4. Connectez les sockets de données requis pour l'opération choisie (par ex. JSON Data pour INSERT).

5. Envoyez un signal true à Enable pour lancer l'opération.

6. Inspectez Output Data et Success? pour poursuivre le traitement dans votre scénario.

💡 Conseils et astuces

• Pour établir les connexions, utilisez SQL-DB Client Connect pour créer et fournir le socket DB Client.

• Préparez les payloads d'insertion/mise à jour avec Data to JSON afin que le format corresponde aux entrées JSON/dictionnaire attendues.

• Si vous construisez des chaînes SQL dynamiquement, utilisez String Input ou String Merge pour composer la requête ou l'instruction avant de les envoyer dans Query String ou Statement String.

• Stockez ou partagez des clients DB ou des résultats fréquemment utilisés en combinant Data Write Local / Data Read Local ou les variantes globales pour un accès inter‑scénarios.

• Utilisez Parse Data Dictionary pour extraire des champs des lignes retournées par une requête et les alimenter dans d'autres blocs.

• Utilisez Debug Input pour consigner et inspecter rapidement les données intermédiaires entrantes lors du dépannage.

• Si vous devez sauvegarder les résultats d'une requête pour plus tard, combinez avec CSV Export pour écrire les données de sortie dans un fichier.

🛠️ Dépannage

• DB Client n'est pas valide Assurez-vous d'avoir connecté un client de base de données approprié (utilisez SQL-DB Client Connect). Le bloc affichera une erreur si le client est manquant ou invalide.

• L'opération retourne une erreur Vérifiez le payload JSON fourni ou la chaîne SQL pour en assurer la validité. Utilisez Debug Input ou Parse Data Dictionary pour inspecter les entrées et sorties.

• Aucune réponse ou attente longue Le bloc exécute les opérations en arrière‑plan, mais les requêtes lourdes peuvent prendre du temps. Gardez les requêtes petites ou vérifiez que la base de données est accessible et réactive.

• JSON mal formé Lors de l'utilisation d'entrées JSON, validez le JSON avec Data to JSON ou vérifiez le contenu avec des blocs de logging avant de connecter.

Si les problèmes persistent, consultez la sortie de messages/log du bloc pour obtenir des indices et ajustez les entrées ou les paramètres de la base de données en conséquence.