fn_registry/functions/infra/db_query.md

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_query	function	go	infra	1.0.0	impure	func DBQuery(db *sql.DB, query string, args ...any) ([]map[string]any, error)	Ejecuta un SELECT y retorna los resultados como slice de maps. Convierte valores a tipos nativos Go segun el tipo de columna reportado por el driver.	database sql query select generic pendiente-usar				false	error_go_core	database/sql	name desc db conexion sql.DB abierta name desc query statement SELECT con placeholders ? name desc args argumentos para los placeholders en la query	slice de maps donde cada map es una fila con columna → valor	false			functions/infra/db_query.go

Ejemplo

rows, err := DBQuery(db, "SELECT id, name, score FROM players WHERE active = ?", true)
if err != nil {
    return err
}
for _, row := range rows {
    fmt.Println(row["name"], row["score"])
}

Notas

Agnóstica al driver — funciona con cualquier *sql.DB (sqlite, duckdb, postgres, clickhouse). Usa sql.RawBytes + ColumnTypes() para conversion dinamica. Convierte INTEGER→int64, FLOAT/REAL/DOUBLE→float64, BOOLEAN→bool, BLOB→[]byte, NULL→nil, resto→string. Para queries con muchos resultados considerar paginar con LIMIT/OFFSET.