DokumentationWorkflowsApps und Services
MySQL Node
Führt eine vorbereitete SQL-Abfrage gegen deine konfigurierte MySQL-Datenbank aus. Die Standardvariante erlaubt ausschließlich SELECT; Schreib- und Schemaoperationen brauchen expliziten Vollzugriff. Hier findest du Einrichtung, Felder, Ein- und Ausgaben, Testablauf und Fehlerbehebung.
8 Min LesezeitAktualisiert am
Was MySQL macht
Führt eine vorbereitete SQL-Abfrage gegen deine konfigurierte MySQL-Datenbank aus. Die Standardvariante erlaubt ausschließlich SELECT; Schreib- und Schemaoperationen brauchen expliziten Vollzugriff.
- Verarbeitet einen Eingang.
- Stellt einen Ausgang für weitere Schritte bereit.
- Wird als normaler Schritt in den Ablauf eingebunden.
Node einrichten
- 01Öffne einen Workflow und füge „MySQL“ über Bausteine hinzu.
- 02Wähle im Node-Panel deine Verbindung für mysql. Falls noch keine besteht, öffnet sich die Einrichtung direkt im Workflow.
- 03Fülle die erforderlichen Felder aus. Werte aus vorherigen Schritten kannst du als Variable einsetzen.
- 04Nutze Testdaten oder starte einen Testlauf und prüfe die Ausgabe des Nodes.
- 05Verbinde den erfolgreichen Ausgang mit dem nächsten Schritt und aktiviere den Workflow erst nach einem vollständigen Probelauf.
Aktionen und Betriebsarten
MySQL hat eine klar abgegrenzte Aufgabe. Die verfügbaren Einstellungen erscheinen direkt im Node-Panel, sobald du den Node auswählst.
Einstellungen
| Feld | Bedeutung | Bereich |
|---|---|---|
| Verbindungsquelle | Standardmäßig wird der unter Konnektoren eingerichtete MySQL-Zugang verwendet. Alternativ kannst du ein verschlüsseltes Workflow-Secret nutzen. | Standard |
| Verbindungs-Secret | Workflow-Secret mit mysql://… oder JSON {host,port,database,user,password,ssl}. Im Workflow wird nur der Secret-Name gespeichert. | Standard |
| Nur SELECT (read-only) | An: nur einzelne SELECT-Statements in einer READ-ONLY-Transaktion. Ausschalten erlaubt Schreiben nur bei uneingeschränkt konfiguriertem Connector. | Standard |
| SQL | Wird im Node-Panel konfiguriert. | Standard |
| Parameter | Werte für die ?-Platzhalter in ihrer Reihenfolge. | Standard |
| Für jedes Item einzeln ausführen | Aus (Standard): der Node läuft einmal für den gesamten Input. An: bekommt er mehrere Items (z. B. aus „Liste aufteilen“), läuft er einmal PRO Item, und {{ $json }} ist dabei jeweils genau dieses Item. So arbeitest du eine Dateiliste Eintrag für Eintrag ab. | Erweitert |
| Wenn ein Item fehlschlägt | „Überspringen“ schreibt für das fehlgeschlagene Item ein `error`-Feld und verarbeitet die übrigen weiter, statt den ganzen Lauf an einer einzigen unlesbaren Datei scheitern zu lassen. | Erweitert |
| Pause zwischen Items (Millisekunden) | Wartezeit vor jedem Durchlauf außer dem ersten. 1000 = 1 Sekunde pro Item. Nützlich, wenn die Gegenstelle sonst dichtmacht. Maximal 300000 (5 Minuten). | Erweitert |
Eingaben und Ausgaben
| Eingabe | Bedeutung | Typ |
|---|---|---|
| params | Positionale Parameter für die ?-Platzhalter. | json |
| Ausgabe | Bedeutung | Typ |
|---|---|---|
| rows | Zeilen-Array des Query-Ergebnisses. | json |
| rowCount | Anzahl gelesener oder betroffener Zeilen. | number |
Dieser Node kann Listen Item für Item verarbeiten. Fehlerbehandlung und Pause zwischen Items findest du in den erweiterten Einstellungen.
Beispiel und Testlauf
User-Lookup: Starte den Node zunächst mit einem kleinen, eindeutig erkennbaren Datensatz. Öffne danach die Ausgabe und verwende nur Felder, die dort tatsächlich vorhanden sind.
Beispiel für einen Testlauf
{
"user_id": "user-42"
}Zugriff und Sicherheit
Der Node verwendet eine verbundene mysql-Verbindung. Prüfe die angezeigten Berechtigungen beim Verbinden und gib nur die benötigten Bereiche frei.
Schlüssel und Zugangsdaten gehören in die geschützte Verbindungsverwaltung. Trage sie nicht als normalen Text in Workflow-Felder, Testdaten oder Beschreibungen ein.
Häufige Fehler beheben
- Keine Ausgabe: Prüfe den letzten Testlauf und ob der vorherige Node die erwarteten Felder geliefert hat.
- Variable bleibt leer: Öffne die Ausgabe des vorherigen Schritts und übernimm den Feldnamen aus den echten Testdaten.
- Verbindung abgelehnt: Verbinde den Dienst erneut und erteile nur die Berechtigungen, die dieser Schritt benötigt.
- Liste wird nur einmal verarbeitet: Aktiviere die Ausführung pro Item in den erweiterten Einstellungen.