fn_registry/functions/infra/db_insert_row.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_insert_row	function	go	infra	1.0.0	impure	func DBInsertRow(db *sql.DB, table string, row map[string]any) (int64, error)	Genera y ejecuta un INSERT de una sola fila desde un map columna→valor. Retorna el last insert ID. Sanitiza nombres de tabla y columnas.	database sql insert row dynamic				false	error_go_core	database/sql sort strings	name desc db conexion sql.DB abierta name desc table nombre de la tabla donde insertar name desc row mapa de columna → valor con los datos a insertar	ID autoincrementado de la fila insertada	false			functions/infra/db_insert_row.go

Ejemplo

id, err := DBInsertRow(db, "users", map[string]any{
    "name":   "Alice",
    "email":  "alice@example.com",
    "active": true,
})
if err != nil {
    return err
}
fmt.Printf("nuevo usuario ID: %d\n", id)

Notas

Las claves del map se ordenan alfabeticamente para generar queries deterministas. Valida tabla y columnas con regex ^[a-zA-Z_][a-zA-Z0-9_]*$. Para insertar muchas filas usar DBInsertBatch que es mas eficiente. El last insert ID puede ser 0 en drivers que no lo soportan (ej: postgres — usar RETURNING en su lugar con DBQuery).