SQL-DB Client Connect

Ce bloc de fonction sert à configurer et établir une connexion vers une base de données SQL (MySQL, PostgreSQL, MSSQL, SQLite). Utilisez-le pour créer un client de base de données persistant que d'autres blocs peuvent réutiliser pour exécuter des requêtes ou manipuler des données.

📥 Entrées

Ce bloc de fonction n'a pas de prises d'entrée.

📤 Sorties

• DB Client — Un objet client de base de données réutilisable que d'autres blocs (par exemple SQL-DB Operations) peuvent utiliser pour exécuter des requêtes et des transactions.

• Connection Success — Un booléen indiquant si la connexion a été établie avec succès.

🕹️ Contrôles

• Database Type — Un menu déroulant pour choisir le type de base de données (MySQL, PostgreSQL, MSSQL, SQLite). Le choix SQLite simplifie l'interface car aucun host/port/user/password n'est requis.

• Host — Nom d'hôte ou adresse IP du serveur de base de données. Masqué pour SQLite.

• Database — Nom de la base de données. Pour SQLite, ce champ sert de chemin vers le fichier de base de données.

• Port — Port TCP du serveur de base de données. Masqué pour SQLite.

• User — Nom d'utilisateur de la base de données. Masqué pour SQLite.

• Password — Mot de passe de la base de données. Masqué pour SQLite.

Remarque : modifier l'un de ces champs réinitialisera la connexion existante et déclenchera une nouvelle tentative de connexion lors de l'évaluation du bloc.

🎯 Fonctionnalités

• Support simple multi-SGBD via une interface unifiée pour les backends SQL courants.

• Compatibilité SQLite avec champs réduits lorsque la base de données est fichier.

• Produit un DB Client prêt à l'emploi et un indicateur Connection Success pour la logique en aval et la gestion d'erreurs.

• Reconnexion automatique lorsque la configuration change.

📝 Instructions d'utilisation

1. Sélectionnez le Database Type correspondant à votre serveur.

2. Remplissez Host, Port, User, Password et Database selon le cas (pour SQLite, indiquez le chemin du fichier dans Database).

3. Lancez votre scénario ou évaluez le bloc. Le bloc tentera de se connecter et définira Connection Success en conséquence.

4. Utilisez le DB Client fourni avec SQL-DB Operations pour effectuer des requêtes, insertions, mises à jour ou autres opérations.

5. Si vous modifiez un champ de connexion, le bloc réinitialisera la connexion et tentera de se reconnecter lors de la prochaine évaluation.

📊 Évaluation

À l'évaluation, le bloc valide les paramètres fournis et tente d'établir la connexion. En cas de succès, il expose un client réutilisable via la sortie DB Client et met Connection Success à true. En cas d'échec, il enregistre une erreur et met Connection Success à false.

💡 Astuces

• Combinez avec SQL-DB Operations pour exécuter des requêtes et injecter les résultats dans le flux.

• Utilisez Data to JSON pour sérialiser des résultats complexes avant de les écrire dans un fichier ou de les envoyer sur le réseau.

• Utilisez CSV Export ou Image Logger (pour les métadonnées d'image) pour persister les résultats issus des requêtes.

• Utilisez Data Write Local ou Data Write Global pour stocker le DB Client ou des résultats récents afin de les réutiliser dans différentes parties du projet.

• Utilisez Debug Input pour inspecter les sorties brutes de SQL-DB Operations lors du développement et du dépannage.

🛠️ Dépannage

• Connexion échoue alors que les identifiants sont corrects : vérifiez l'accès réseau vers Host et que le Port sélectionné est ouvert et accepte les connexions.

• Utilisation de SQLite : assurez-vous que le chemin indiqué dans Database est accessible et que l'application a les permissions de lecture/écriture sur ce fichier.

• Les changements de configuration ne semblent pas être pris en compte : modifiez un contrôle (par exemple Host) pour forcer le bloc à réinitialiser et rétablir la connexion.

• Pour vérifier les données retournées pendant le développement, connectez SQL-DB Operations et Debug Input afin d'inspecter les réponses avant de les intégrer.