DB Scalar

DB Scalar

Tipo: db-scalar  ·  Paquete: Database Activities v1.0.0  ·  Salida: object

Ejecuta un SELECT que devuelve un solo valor y lo devuelve directamente. Es la forma cómoda de obtener un dato puntual de la base de datos: un conteo (COUNT(*)), un máximo (MAX(Fecha)), un total (SUM(Monto)), o el valor de una celda concreta — sin tener que manejar una DataTable.

Cómo funciona

Ejecuta la consulta y devuelve el valor de la primera columna de la primera fila. 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	Una sentencia SQL que devuelve un único valor. 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 object con el valor (número, texto, fecha…). Conviértelo si lo necesitas con toNumber(...), str(...), etc.

Ejemplo

Contar los pedidos pendientes de un cliente:

DB Scalar
  sql    = "SELECT COUNT(*) FROM Pedidos WHERE ClienteId = @id AND Estado = 'pendiente'"
  params = { "id": = clienteId }
  → output: pendientes

If   condition = = toNumber(pendientes) > 0
 └─ then:
      Log   message = = "El cliente tiene " + pendientes + " pedidos pendientes"

Scalar vs Query

• DB Scalar: cuando esperas un solo valor (un número, un dato). Más simple.
• DB Query: cuando esperas varias filas/columnas (devuelve una DataTable).

Actividades relacionadas

• DB Query — para resultados de varias filas.
• DB Execute — para modificar datos.