xorm框架执行原生sql查询主要依赖引擎实例提供的 query 和 queryinterface 方法。调用时传入完整的sql语句及参数,前者返回字节切片数组,后者允许通过回调函数处理每一行数据。若需将结果映射到结构体,可结合 rows 获取游标后手动扫描,或直接使用 queryinterface 在循环中赋值。

如何获取原始字节数据并解析
使用 engine.Query(sql, args...) 可直接获取未处理的二维字节切片。该方法适合不需要复杂对象转换、仅需快速读取数据的场景,返回的 [][]byte 结构对应数据库的行与列,开发者需自行进行类型转换。

package main
import (
"fmt"
"log"
"xorm.io/xorm"
_ "github.com/go-sql-driver/mysql"
)
type User struct {
Id int64
Name string
}
func main() {
env := xorm.NewEngine("mysql", "user:pass@tcp(127.0.0.1:3306)/db")
// 执行原生查询
rows, _, err := env.Query("SELECT id, name FROM user WHERE id = ?", 1)
if err != nil {
log.Fatal(err)
}
// 遍历结果
for _, row := range rows {
idBytes := row["id"]
nameBytes := row["name"]
fmt.Printf("ID: %s, Name: %s\n", string(idBytes), string(nameBytes))
}
}
上述代码执行后,控制台将输出对应字段的字符串表示。由于 Query 返回的是 []map[string][]byte,键名为数据库字段名(或别名),值为字节切片。这种方式避免了结构体映射的开销,但需要处理空值和类型转换逻辑。
如何通过回调逐行处理数据
当数据量较大或需要实时处理时,QueryInterface 是更优选择。它接受一个回调函数,每读取一行就调用一次该函数,参数为当前行的 map[string][]byte。这种方式内存占用更低,且能灵活控制每一行的处理逻辑。

package main
import (
"fmt"
"log"
"xorm.io/xorm"
_ "github.com/go-sql-driver/mysql"
)
func main() {
env := xorm.NewEngine("mysql", "user:pass@tcp(127.0.0.1:3306)/db")
var count int
// 使用 QueryInterface 逐行处理
err := env.QueryInterface("SELECT id, name FROM user", func(rows *sql.Rows) (bool, error) {
var id int64
var name string
if err := rows.Scan(&id, &name); err != nil {
return false, err
}
count++
fmt.Printf("Processed: ID=%d, Name=%s\n", id, name)
return true, nil
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("Total rows processed: %d\n", count)
}
运行此程序会逐行打印用户信息,并在结束后统计总行数。注意 QueryInterface 内部使用了标准的 database/sql 接口,因此可以直接使用 rows.Scan 将数据填入变量。回调函数返回 true 继续下一行,返回 false 则提前终止遍历。这种方法在处理大表或流式数据时非常高效,且能避免一次性加载所有数据到内存。
如何将原生SQL结果映射到结构体
虽然 Query 系列方法不直接支持结构体映射,但可以通过 Rows 方法获取标准游标,再结合 xorm.RowsToSlice 或手动扫描实现。对于简单场景,推荐使用 QueryInterface 配合结构体字段赋值;对于复杂嵌套结构,建议先获取 []map[string][]byte 再反序列化。例如,若需将结果转为 User 结构体切片,可在回调中创建实例并填充字段,最后收集到切片中返回。











