Write Data Node
Realizar operaciones de escritura en base de datos contra una fuente de datos.
Descripción general
El Write Data Node ejecuta operaciones de inserción, actualización, upsert o eliminación contra una fuente de datos seleccionada. Úselo para persistir resultados de flujos de trabajo, actualizar registros o gestionar datos en las tablas de su proyecto.
Funciona con Ubex Tables. Cualquier tabla que cree en My Data puede usarse aquí como fuente de datos. Almacene usuarios, productos, pedidos o cualquier dato directamente en Ubex — sin necesidad de una base de datos externa. Consulte la documentación de My Data para saber cómo crear tablas.
Configuración
| Campo | Descripción | Obligatorio |
|---|---|---|
Select Datasource |
La tabla o fuente de datos de destino | Sí |
Operation |
Insert, Update, Upsert o Delete | Sí |
Output Variable |
Nombre de la variable para almacenar el resultado | Sí |
Operaciones
| Operación | Descripción |
|---|---|
Insert |
Agrega una nueva fila a la tabla |
Update |
Modifica filas existentes que coincidan con las condiciones especificadas |
Upsert |
Inserta una nueva fila o la actualiza si ya existe una coincidencia |
Delete |
Elimina filas que coincidan con las condiciones especificadas |
Mapeo de columnas
Para las operaciones Insert, Update y Upsert, asigne valores a las columnas de la tabla:
| Propiedad | Descripción |
|---|---|
Name |
El nombre de la columna |
Type |
El tipo de dato de la columna (TEXT, SELECT, LONGTEXT, NUMBER, DATE) |
Required |
Se muestra en rojo si la columna es obligatoria |
Value |
Valor literal o referencia {{variable}} |
Condiciones Where (Update / Delete)
Defina qué filas se verán afectadas. Cada condición consta de:
- Columna - Seleccionar de las columnas disponibles de la tabla
- Operador - Operador de comparación
- Valor - El valor de comparación (admite sintaxis
{{variable}})
Operadores
| Operador | Descripción |
|---|---|
= |
Igual a (predeterminado) |
≠ |
Diferente de |
> |
Mayor que |
< |
Menor que |
≥ |
Mayor o igual que |
≤ |
Menor o igual que |
Contains |
Contiene el valor |
Is Empty |
El campo está vacío |
Is Not Empty |
El campo no está vacío |
Columnas de coincidencia (Upsert)
Para operaciones Upsert, seleccione una o más columnas utilizadas para detectar filas existentes. Si se encuentra una coincidencia, la fila se actualiza; de lo contrario, se inserta una nueva fila.
Opciones
| Opción | Tipo | Predeterminado | Descripción |
|---|---|---|---|
Return inserted/updated row |
Interruptor | Activado | Devuelve los datos de la fila afectada en la variable de salida |
Embed immediately |
Interruptor | Desactivado | Bloquea la ejecución hasta que se complete el embedding |
Ejemplo: Insertar un nuevo registro
Datasource: users
Operation: Insert
Column Mapping:
name → {{form_data.name}}
email → {{form_data.email}}
role → "member"
created_at → {{current_time}}
Output Variable: writeResult
Ejemplo: Actualizar un registro existente
Datasource: orders
Operation: Update
Where: order_id = {{order_id}}
Column Mapping:
status → "completed"
completed_at → {{current_time}}
Output Variable: updateResult
Ejemplo: Upsert (Insertar o Actualizar)
Datasource: user_preferences
Operation: Upsert
Match Columns: user_id
Column Mapping:
user_id → {{user.id}}
theme → {{selected_theme}}
language → {{selected_language}}
Output Variable: upsertResult
Ejemplo: Eliminar registros
Datasource: temp_sessions
Operation: Delete
Where: created_at < {{expiry_date}}
Output Variable: deleteResult
Buenas prácticas
- Siempre use condiciones Where para Update y Delete para evitar afectar todas las filas
- Use Upsert cuando no esté seguro de si un registro ya existe
- Active "Return inserted/updated row" cuando necesite el resultado en nodos posteriores
- Use nombres descriptivos para las variables de salida para rastrear qué operación produjo los datos