DB Execute

DB Execute

Tipo: db-execute  ·  Paquete: Database Activities v1.0.0  ·  Salida: int

Ejecuta una sentencia que modifica datos —INSERT, UPDATE o DELETE— y devuelve el número de filas afectadas. Es la actividad de escritura en la base de datos: insertar registros, actualizar estados, borrar datos.

Cómo funciona

Ejecuta la sentencia sobre la conexión y devuelve cuántas filas cambió. Usa parámetros @nombre y el campo params para los valores variables (ver consultas parametrizadas).

Parámetros requeridos

Parámetro	Editor	Descripción
sql	expresión	La sentencia INSERT, UPDATE o DELETE. Usa @nombre para los parámetros.

Parámetros opcionales

Parámetro	Editor	Descripción
session	sesión	Sesión de DB Connect. Dentro de un body se hereda automáticamente; fuera, pasa = db.
params	JSON	Valores de los parámetros, como objeto { nombre: valor }.

Salida

Devuelve un int con el número de filas afectadas. Útil para verificar que la operación impactó lo esperado.

Ejemplo

Marcar un pedido como despachado:

DB Execute
  sql    = "UPDATE Pedidos SET Estado = @estado WHERE Id = @id"
  params = { "estado": "despachado", "id": = pedidoId }
  → output: filasAfectadas

If   condition = = filasAfectadas == 0
 └─ then:
      Log   level = warning   message = = "Ningún pedido con id " + pedidoId

Usa parámetros, no concatenación

Igual que en DB Query: pasa los valores con params, nunca concatenados en el SQL. Protege contra errores e inyección SQL.

Actividades relacionadas

• DB Query — leer datos con SELECT.
• DB Scalar — leer un único valor.