Files
fn_registry/functions/infra/db_exec.md
egutierrez 5f4f1f7508 docs: params/output semántico en 506 funciones para composabilidad
Añade campos params y output al frontmatter YAML de las 506 funciones del registry.
Cada parámetro tiene descripción semántica (qué representa, unidades, rango típico)
y cada función describe qué produce su output. Permite a agentes razonar sobre
cadenas de composición (ej: prices → log_return → sharpe_ratio) sin leer código.
2026-04-05 18:45:16 +02:00

1.2 KiB

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path
name kind lang domain version purity signature description tags uses_functions uses_types returns returns_optional error_type imports params output tested tests test_file_path file_path
db_exec function go infra 1.0.0 impure func DBExec(db *sql.DB, query string, args ...any) (int64, error) Ejecuta un statement no-SELECT (INSERT, UPDATE, DELETE, DDL) y retorna el numero de filas afectadas.
database
sql
exec
insert
update
delete
ddl
false error_go_core
database/sql
name desc
db conexion sql.DB abierta
name desc
query statement SQL no-SELECT (INSERT, UPDATE, DELETE, DDL) con placeholders ?
name desc
args argumentos para los placeholders en la query
numero de filas afectadas por la ejecucion false
functions/infra/db_exec.go

Ejemplo

n, err := DBExec(db, "UPDATE users SET active = ? WHERE last_login < ?", false, cutoff)
if err != nil {
    return err
}
fmt.Printf("desactivados: %d usuarios\n", n)

Notas

Agnóstica al driver. Para DDL algunos drivers retornan 0 en RowsAffected — esto es normal. Para INSERT con last_insert_id usar DBInsertRow que retorna ese valor. Para multiples filas en una transaccion usar DBInsertBatch.