SQL-DB Operations

Dieser Funktionsblock ermöglicht gängige SQL-Aktionen (INSERT, QUERY, UPDATE, DELETE, EXECUTE) auf einer verbundenen Datenbank. Die Benutzeroberfläche ist einfach: Sie wählen die gewünschte Operation, geben bei Bedarf einen Table Name ein und versorgen die benötigten Eingänge über Sockets. Operationen laufen im Hintergrund, damit die Oberfläche reaktionsfähig bleibt.

📥 Eingänge (sockets)

Je nach gewählter SQL-Operation stellt der Block unterschiedliche Eingangs-Sockets bereit. Jeder unten aufgeführte Name ist ein Socket, den Sie mit anderen Blöcken verbinden können.

Gemeinsame Sockets für alle Methoden

• Enable Muss auf true gesetzt werden, damit die gewählte Operation ausgeführt wird.

• DB Client Eine Datenbank-Client-Referenz, die von einem separaten Verbindungsblock bereitgestellt wird (siehe Tips and Tricks).

Per-Methode Sockets

• INSERT

  • JSON Data Daten, die in die gewählte Tabelle eingefügt werden (JSON/Dictionary).

• QUERY

  • Query String SQL-SELECT oder andere Abfragezeichenfolge, die ausgeführt werden soll.

• UPDATE

  • JSON Data Update-Werte (JSON/Dictionary).

  • JSON Data(Where Conditions) Where-Bedingungen zur Auswahl der zu ändernden Zeilen.

• DELETE

  • JSON Data(Where Conditions) Where-Bedingungen zur Auswahl der zu löschenden Zeilen.

• EXECUTE

  • Statement String Roh-SQL-Anweisung zur Ausführung (vorsichtig verwenden).

Hinweis: Der Block zeigt bzw. versteckt die Eingabesteuerung Table Name, je nach gewählter Operation.

📤 Ausgänge (sockets)

• Output Data Gibt das Ergebnis der Operation zurück (z. B. Abfragezeilen, Informationen zu betroffenen Zeilen oder operationsspezifische Daten).

• Success? Boolean, der anzeigt, ob die Operation erfolgreich abgeschlossen wurde.

🕹️ Steuerungen (widgets)

• Select SQL Operation Dropdown zur Auswahl einer der Optionen: INSERT / QUERY / UPDATE / DELETE / EXECUTE. Die verfügbaren Eingangs-Sockets passen sich entsprechend an.

• Table Name Textfeld für den Zieltabellennamen. Wird automatisch ausgeblendet, wenn nicht erforderlich (z. B. bei EXECUTE).

⚙️ Ablauf / Ausführungsmechanismus

• Der Block läuft nur, wenn der Enable-Socket ein true erhält.

• Er benötigt einen gültigen DB Client-Socket (in der Regel von einem Datenbankverbindungs-Block bereitgestellt).

• Bei Auslösung führt der Block die gewählte Operation im Hintergrund aus und liefert nach Abschluss Output Data und Success?.

• Probleme (z. B. ungültige Eingaben, fehlender Client, fehlerhaftes JSON oder SQL-Fehler) werden im Nachrichten-/Logbereich des Blocks angezeigt.

✨ Wichtige Funktionen

• Dynamische Sockets, die sich an die gewählte SQL-Operation anpassen und so die UI aufgeräumt halten.

• Hintergrundausführung für eine reaktionsfähige Oberfläche bei lang laufenden DB-Aufrufen.

• Einfache JSON-basierte Eingaben für INSERT und UPDATE, um tabellarische Daten leicht zu übergeben.

• Deutliche Erfolgsmeldung und zurückgegebene Ergebnisdaten zur Weiterverarbeitung.

📝 Nutzungshinweise

1. Stellen Sie einen Datenbank-Client über den DB Client-Socket bereit (siehe Tips and Tricks).

2. Wählen Sie die gewünschte Operation über Select SQL Operation.

3. Falls erforderlich, geben Sie die Ziel-Tabelle in Table Name ein.

4. Verbinden Sie die benötigten Datensockets für die gewählte Operation (z. B. JSON Data für INSERT).

5. Senden Sie ein true-Signal an Enable, um die Operation auszuführen.

6. Prüfen Sie Output Data und Success?, um im Szenario weiterzuarbeiten.

💡 Tips and Tricks

• Verwenden Sie SQL-DB Client Connect, um einen DB Client zu erstellen und bereitzustellen.

• Bereiten Sie INSERT-/UPDATE-Payloads mit Data to JSON vor, damit das Format mit erwarteten JSON/Dictionary-Eingaben übereinstimmt.

• Falls Sie SQL-Strings dynamisch erzeugen, nutzen Sie String Input oder String Merge, um die Abfrage bzw. Anweisung vor dem Einspeisen in Query String oder Statement String zusammenzusetzen.

• Häufig genutzte DB-Clients oder Ergebnisse können mit Data Write Local / Data Read Local oder den globalen Varianten gespeichert/geteilt werden.

• Verwenden Sie Parse Data Dictionary, um Felder aus zurückgegebenen Abfragezeilen zu extrahieren und in andere Blöcke zu leiten.

• Debug Input hilft, Zwischenwerte schnell zu protokollieren und zu prüfen.

• Um Abfrageergebnisse zu speichern, kombinieren Sie mit CSV Export.

🛠️ Fehlersuche

• DB Client ist nicht gültig Stellen Sie sicher, dass Sie einen gültigen Datenbank-Client verbunden haben (verwenden Sie SQL-DB Client Connect). Der Block zeigt einen Fehler an, wenn der Client fehlt oder ungültig ist.

• Operation gibt Fehler zurück Prüfen Sie das bereitgestellte JSON-Payload oder den SQL-String auf Korrektheit. Nutzen Sie Debug Input oder Parse Data Dictionary, um Eingaben und Ausgaben zu inspizieren.

• Keine Antwort oder lange Wartezeit Der Block führt Operationen im Hintergrund aus, aber lange Abfragen können Zeit benötigen. Halten Sie Abfragen schlank oder prüfen Sie, ob die Datenbank erreichbar und responsiv ist.

• Fehlerhaftes JSON Validieren Sie JSON-Eingaben mit Data to JSON oder prüfen Sie die Inhalte mit Logging-Blöcken, bevor Sie sie verbinden.

Wenn Probleme weiterhin bestehen, lesen Sie die Meldungen im Logbereich des Blocks und passen Sie Eingaben oder Datenbankeinstellungen entsprechend an.