SQL-DB Client Connect

Dieser Funktionsblock wird verwendet, um eine Verbindung zu einer SQL-Datenbank (MySQL, PostgreSQL, MSSQL, SQLite) zu konfigurieren und herzustellen. Verwenden Sie ihn, um einen persistenten Datenbank-Client zu erstellen, den andere Blöcke zum Ausführen von Abfragen oder für Datenoperationen verwenden können.

📥 Eingänge

Dieser Funktionsblock hat keine Eingangsanschlüsse.

📤 Ausgänge

• DB Client Ein wiederverwendbares Datenbank-Client-Objekt, das von anderen Blöcken (z. B. SQL-DB Operations) verwendet werden kann, um Abfragen und Transaktionen auszuführen.

• Connection Success Ein Boolean, der anzeigt, ob die Verbindung erfolgreich hergestellt wurde.

🕹️ Steuerungen

• Database Type Ein Dropdown, um den Datenbanktyp auszuwählen (MySQL, PostgreSQL, MSSQL, SQLite). Bei Auswahl von SQLite wird die UI vereinfacht, da Host/Port/User/Password nicht erforderlich sind.

• Host Hostname oder IP-Adresse des Datenbankservers. Für SQLite ausgeblendet.

• Database Name der Datenbank. Bei SQLite wird dieses Feld als Pfad zur Datenbankdatei verwendet.

• Port TCP-Port des Datenbankservers. Für SQLite ausgeblendet.

• User Datenbank-Benutzername. Für SQLite ausgeblendet.

• Password Datenbank-Passwort. Für SQLite ausgeblendet.

Hinweis: Änderungen an einem dieser Felder setzen die bestehende Verbindung zurück und lösen beim nächsten Auswerten des Blocks einen neuen Verbindungsversuch aus.

🎯 Features

• Einfache Multi-Database-Unterstützung mit einer einheitlichen UI für gängige SQL-Backends.

• SQLite-Kompatibilität mit reduzierten Feldern bei Auswahl einer dateibasierten Datenbank.

• Liefert ein einsatzbereites DB Client und eine Connection Success-Flag für nachgelagerte Logik und Fehlerbehandlung.

• Automatische Wiederverbindung bei erkannten Konfigurationsänderungen.

📝 Nutzungshinweise

1. Wählen Sie Database Type, das zu Ihrem Server passt.

2. Füllen Sie Host, Port, User, Password und Database entsprechend aus (bei SQLite geben Sie den Dateipfad in Database an).

3. Führen Sie Ihr Szenario aus oder werten Sie den Block aus. Der Block versucht, eine Verbindung herzustellen, und setzt Connection Success entsprechend.

4. Verwenden Sie den bereitgestellten DB Client zusammen mit SQL-DB Operations, um Abfragen, Inserts, Updates oder andere Datenbankaufgaben durchzuführen.

5. Wenn Sie Verbindungsfelder ändern, setzt der Block die aktuelle Verbindung zurück und versucht beim nächsten Auswerten erneut, die Verbindung herzustellen.

📊 Bewertung

Bei der Auswertung validiert der Block die angegebenen Parameter und versucht, eine Verbindung herzustellen. Bei Erfolg stellt er über die Ausgabe DB Client einen wiederverwendbaren Client bereit und setzt Connection Success auf true. Bei einem Fehler protokolliert er einen Fehler und setzt Connection Success auf false.

💡 Tipps und Tricks

• Kombinieren Sie mit SQL-DB Operations, um Abfragen auszuführen und Ergebnisse in den Flow zurückzugeben.

• Verwenden Sie Data to JSON, um komplexe Ergebnisse zu serialisieren, bevor Sie sie in Dateien schreiben oder über ein Netzwerk senden.

• Nutzen Sie CSV Export oder Image Logger (für bildbezogene Metadaten), um Ergebnisse aus Datenbankabfragen zu persistieren.

• Verwenden Sie Data Write Local oder Data Write Global, um den DB Client oder jüngste Abfrageergebnisse zur Wiederverwendung in anderen Projektteilen zu speichern.

• Nutzen Sie Debug Input, um rohe Ausgaben von SQL-DB Operations beim Erstellen und Debuggen des Szenarios zu inspizieren.

🛠️ Fehlersuche

• Verbindung schlägt fehl, obwohl die Zugangsdaten korrekt sind: Prüfen Sie den Netzwerkzugang zum Host und ob der gewählte Port offen und erreichbar ist.

• Bei Verwendung von SQLite: Stellen Sie sicher, dass der in Database angegebene Pfad zugänglich ist und die Anwendung Lese-/Schreibrechte für diese Datei hat.

• Wenn Konfigurationsänderungen nicht zu greifen scheinen: Bearbeiten Sie ein beliebiges Steuerelement (z. B. Host), um den Block zum Zurücksetzen und erneuten Herstellen der Verbindung zu zwingen.

• Wenn Sie Rückgabedaten während der Entwicklung prüfen möchten, hängen Sie SQL-DB Operations und Debug Input an, um Antworten zu inspizieren, bevor Sie sie weiter integrieren.