DB Query

DB Query

Tipo: db-query  ·  Paquete: Database Activities v1.0.0  ·  Salida: DataTable

Ejecuta una consulta SELECT y devuelve los resultados como una DataTable, lista para recorrer, filtrar o volcar a Excel. Es la actividad de lectura más común.

Cómo funciona

Ejecuta el SELECT sobre la conexión y devuelve sus filas en una DataTable, con una columna por cada columna del resultado. 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 SELECT. 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 DataTable. Recórrelo con For Each y accede a celdas con str(fila["Columna"]).

Ejemplo

DB Query
  sql    = "SELECT Id, Nombre, Saldo FROM Clientes WHERE Ciudad = @ciudad"
  params = { "ciudad": = ciudadBuscada }
  → output: clientes

Log   message = = "Clientes encontrados: " + rowCount(clientes)
For Each   items = = clientes   itemVariable = fila
 └─ activities:
      Log   message = = str(fila["Nombre"]) + ": " + num(fila["Saldo"])

Usa parámetros, no concatenación

Escribe WHERE Ciudad = @ciudad con params, no "WHERE Ciudad = '" + ciudad + "'". Los parámetros evitan errores con comillas y protegen contra la inyección SQL.

Actividades relacionadas

• DB Scalar — cuando el SELECT devuelve un solo valor.
• DB Execute — para INSERT/UPDATE/DELETE.
• DataTable — filtrar, ordenar y resumir el resultado.