Write Data Node
Execută operațiuni de scriere în baza de date asupra unei surse de date.
Prezentare generală
Nodul Write Data execută operațiuni de inserare, actualizare, upsert sau ștergere asupra unei surse de date selectate. Folosiți-l pentru a persista rezultatele fluxurilor de lucru, a actualiza înregistrări sau a gestiona datele din tabelele proiectului.
Funcționează cu Ubex Tables. Orice tabel creat în My Data poate fi folosit aici ca sursă de date. Stocați utilizatori, produse, comenzi sau orice date direct în Ubex — fără a avea nevoie de o bază de date externă. Consultați documentația My Data pentru a afla cum să creați tabele.
Configurare
| Câmp | Descriere | Obligatoriu |
|---|---|---|
Select Datasource |
Tabelul sau sursa de date țintă | Da |
Operation |
Insert, Update, Upsert sau Delete | Da |
Output Variable |
Numele variabilei pentru stocarea rezultatului | Da |
Operațiuni
| Operațiune | Descriere |
|---|---|
Insert |
Adaugă un rând nou în tabel |
Update |
Modifică rândurile existente care corespund condițiilor specificate |
Upsert |
Inserează un rând nou sau îl actualizează dacă există deja o potrivire |
Delete |
Elimină rândurile care corespund condițiilor specificate |
Maparea coloanelor
Pentru operațiunile Insert, Update și Upsert, mapați valorile la coloanele tabelului:
| Proprietate | Descriere |
|---|---|
Name |
Numele coloanei |
Type |
Tipul de date al coloanei (TEXT, SELECT, LONGTEXT, NUMBER, DATE) |
Required |
Afișat în roșu dacă coloana este obligatorie |
Value |
Valoare literală sau referință {{variable}} |
Condiții Where (Update / Delete)
Definiți ce rânduri vor fi afectate. Fiecare condiție constă din:
- Coloană - Selectați din coloanele disponibile ale tabelului
- Operator - Operator de comparație
- Valoare - Valoarea de comparație (suportă sintaxa
{{variable}})
Operatori
| Operator | Descriere |
|---|---|
= |
Egal cu (implicit) |
≠ |
Diferit de |
> |
Mai mare decât |
< |
Mai mic decât |
≥ |
Mai mare sau egal cu |
≤ |
Mai mic sau egal cu |
Contains |
Conține valoarea |
Is Empty |
Câmpul este gol |
Is Not Empty |
Câmpul nu este gol |
Coloane de potrivire (Upsert)
Pentru operațiunile Upsert, selectați una sau mai multe coloane folosite pentru detectarea rândurilor existente. Dacă se găsește o potrivire, rândul este actualizat; altfel, se inserează un rând nou.
Opțiuni
| Opțiune | Tip | Implicit | Descriere |
|---|---|---|---|
Return inserted/updated row |
Comutator | Activat | Returnează datele rândului afectat în variabila de ieșire |
Embed immediately |
Comutator | Dezactivat | Blochează execuția până la finalizarea embedding-ului |
Exemplu: Inserarea unei înregistrări noi
Datasource: users
Operation: Insert
Column Mapping:
name → {{form_data.name}}
email → {{form_data.email}}
role → "member"
created_at → {{current_time}}
Output Variable: writeResult
Exemplu: Actualizarea unei înregistrări existente
Datasource: orders
Operation: Update
Where: order_id = {{order_id}}
Column Mapping:
status → "completed"
completed_at → {{current_time}}
Output Variable: updateResult
Exemplu: Upsert (Inserare sau Actualizare)
Datasource: user_preferences
Operation: Upsert
Match Columns: user_id
Column Mapping:
user_id → {{user.id}}
theme → {{selected_theme}}
language → {{selected_language}}
Output Variable: upsertResult
Exemplu: Ștergerea înregistrărilor
Datasource: temp_sessions
Operation: Delete
Where: created_at < {{expiry_date}}
Output Variable: deleteResult
Bune practici
- Folosiți întotdeauna condiții Where pentru Update și Delete pentru a evita afectarea tuturor rândurilor
- Folosiți Upsert când nu sunteți sigur dacă o înregistrare există deja
- Activați „Return inserted/updated row" când aveți nevoie de rezultat în nodurile ulterioare
- Folosiți nume descriptive pentru variabilele de ieșire pentru a urmări ce operațiune a produs datele