Documentation is being updated. Some sections may not reflect the latest features.

Write Data Node

Datenbank-Schreiboperationen gegen eine Datenquelle ausführen.

Überblick

Der Write Data Node führt Insert-, Update-, Upsert- oder Delete-Operationen gegen eine ausgewählte Datenquelle aus. Verwenden Sie ihn, um Workflow-Ergebnisse zu speichern, Datensätze zu aktualisieren oder Daten in den Tabellen Ihres Projekts zu verwalten.

Funktioniert mit Ubex Tables. Jede Tabelle, die Sie unter „My Data" erstellen, kann hier als Datenquelle verwendet werden. Speichern Sie Benutzer, Produkte, Bestellungen oder beliebige Daten direkt in Ubex — keine externe Datenbank erforderlich. Weitere Informationen finden Sie in der My Data Dokumentation.

Konfiguration

Feld Beschreibung Erforderlich
Select Datasource Die Zieltabelle oder Datenquelle Ja
Operation Insert, Update, Upsert oder Delete Ja
Output Variable Variablenname zum Speichern des Ergebnisses Ja

Operationen

Operation Beschreibung
Insert Fügt eine neue Zeile zur Tabelle hinzu
Update Ändert bestehende Zeilen, die den angegebenen Bedingungen entsprechen
Upsert Fügt eine neue Zeile ein oder aktualisiert sie, wenn eine Übereinstimmung existiert
Delete Entfernt Zeilen, die den angegebenen Bedingungen entsprechen

Spaltenzuordnung

Für Insert-, Update- und Upsert-Operationen ordnen Sie Werte den Tabellenspalten zu:

Eigenschaft Beschreibung
Name Der Spaltenname
Type Der Spaltendatentyp (TEXT, SELECT, LONGTEXT, NUMBER, DATE)
Required Wird rot angezeigt, wenn die Spalte obligatorisch ist
Value Literalwert oder {{variable}}-Referenz

Where-Bedingungen (Update / Delete)

Definieren Sie, welche Zeilen betroffen sein sollen. Jede Bedingung besteht aus:

  1. Spalte - Aus verfügbaren Tabellenspalten auswählen
  2. Operator - Vergleichsoperator
  3. Wert - Der Vergleichswert (unterstützt {{variable}}-Syntax)

Operatoren

Operator Beschreibung
= Gleich (Standard)
Ungleich
> Größer als
< Kleiner als
Größer oder gleich
Kleiner oder gleich
Contains Enthält den Wert
Is Empty Feld ist leer
Is Not Empty Feld ist nicht leer

Abgleichspalten (Upsert)

Für Upsert-Operationen wählen Sie eine oder mehrere Spalten aus, die zur Erkennung bestehender Zeilen verwendet werden. Wird eine Übereinstimmung gefunden, wird die Zeile aktualisiert; andernfalls wird eine neue Zeile eingefügt.

Optionen

Option Typ Standard Beschreibung
Return inserted/updated row Umschalter Ein Gibt die betroffenen Zeilendaten in der Ausgabevariable zurück
Embed immediately Umschalter Aus Blockiert die Ausführung, bis das Embedding abgeschlossen ist

Beispiel: Neuen Datensatz einfügen

Datasource: users
Operation: Insert
Column Mapping:
  name → {{form_data.name}}
  email → {{form_data.email}}
  role → "member"
  created_at → {{current_time}}
Output Variable: writeResult

Beispiel: Bestehenden Datensatz aktualisieren

Datasource: orders
Operation: Update
Where: order_id = {{order_id}}
Column Mapping:
  status → "completed"
  completed_at → {{current_time}}
Output Variable: updateResult

Beispiel: Upsert (Einfügen oder Aktualisieren)

Datasource: user_preferences
Operation: Upsert
Match Columns: user_id
Column Mapping:
  user_id → {{user.id}}
  theme → {{selected_theme}}
  language → {{selected_language}}
Output Variable: upsertResult

Beispiel: Datensätze löschen

Datasource: temp_sessions
Operation: Delete
Where: created_at < {{expiry_date}}
Output Variable: deleteResult

Best Practices

  • Verwenden Sie immer Where-Bedingungen für Update und Delete, um zu vermeiden, dass alle Zeilen betroffen sind
  • Verwenden Sie Upsert, wenn Sie unsicher sind, ob ein Datensatz bereits existiert
  • Aktivieren Sie „Return inserted/updated row", wenn Sie das Ergebnis in nachfolgenden Nodes benötigen
  • Verwenden Sie aussagekräftige Ausgabevariablennamen, um nachzuverfolgen, welche Operation die Daten erzeugt hat
AI AssistantPowered by Ubex
Beta
Ask me anything about Ubex workflows, nodes, or the API.
~/

Hallo 👋

Wie können wir Ihnen heute helfen?