一、数据结构
查询结果的数据结构如下：
type Value = *gvar.Var // 返回数据表记录值
type Record map[string]Value // 返回数据表记录键值对
type Result []Record // 返回数据表记录列表Value/Record/Result用于ORM操作的结果数据类型。Result表示 数据表记录列表，Record表示 一条数据表记录，Value表示记录中的 一条键值数据。Value是*gvar.Var类型的别名类型，是一个运行时泛型，以便支持数据表不同的字段类型，方便于后续的数据类型转换。
举个🌰：
二、 Record 数据记录
接口文档： https://pkg.go.dev/github.com/gogf/gf/v2/database/gdb
gdb 为数据表记录操作提供了极高的灵活性和简便性，除了支持以 map 的形式访问/操作数据表记录以外，也支持将数据表记录转换为 struct 进行处理。我们以下使用一个简单的示例来演示该特性。
首先，我们的用户表结构是这样的（简单设计的示例表）：
CREATE TABLE `user` (
`uid` int(10) unsigned NOT NULL AUTO_INCREMENT,
`name` varchar(30) NOT NULL DEFAULT '' COMMENT '昵称',
`site` varchar(255) NOT NULL DEFAULT '' COMMENT '主页',
PRIMARY KEY (`uid`)
) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8;其次，我们的表数据如下：
uid name site
1 john https://goframe.org最后，我们的示例程序如下：
package main
import (
"github.com/gogf/gf/v2/frame/g"
"github.com/gogf/gf/v2/os/gctx"
)
type User struct {
Uid int
Name string
}
func main() {
var (
user *User
ctx = gctx.New()
)
err := g.DB().Model("user").Where("uid", 1).Scan(&user)
if err != nil {
g.Log().Header(false).Fatal(ctx, err)
}
if user != nil {
g.Log().Header(false).Print(ctx, user)
}
}执行后，输出结果为：
{"Uid":1,"Name":"john"}这里，我们自定义了一个 struct，里面只包含了 Uid 和 Name 属性，可以看到它的属性并不和数据表的字段一致，这也是 ORM 灵活的特性之一：支持指定属性获取。
通过 gdb.Model.Scan 方法可以将查询到的数据记录转换为 struct 对象或者 struct 对象数组。由于这里传递的参数为 &user 即 **User 类型，那么将会转换为一个 结构体对象，如果传递为 []*User 类型的参数，将会转换为 结构体数组 结果，请查看后续示例。具体方法介绍请查看链式操作章节。
属性字段映射规则：
需要注意的是， map 中的键名为 uid,name,site，而 struct 中的属性为 Uid,Name，那么他们之间是如何执行映射的呢？主要是以下几点简单的规则：
struct中需要匹配的属性必须为公开属性(首字母大写)；- 记录结果中键名会自动按照
不区分大小写且 忽略-/_/空格符号 的形式与struct属性进行匹配； - 如果匹配成功，那么将键值赋值给属性，如果无法匹配，那么忽略该键值；
以下是几个匹配的示例：
记录键名 struct属性 是否匹配
name Name match
Email Email match
nickname NickName match
NICKNAME NickName match
Nick-Name NickName match
nick_name NickName match
nick_name Nick_Name match
NickName Nick_Name match
Nick-Name Nick_Name match:::tip
由于数据库结果集转 struct 的底层是依靠 gconv.Struct 方法实现的，因此如果想要实现 自定义的属性转换，以及更详细的映射规则说明，请参考 类型转换-Struct转换 章节。
:::
三、 Result 数据集合
Result/Record 数据类型根据数据结果集操作的需要，往往需要根据记录中 特定的字段 作为键名进行数据检索，因此它包含多个用于转换 Map/List 的方法，同时也包含了常用数据结构 JSON/XML 的转换方法。
接口文档： https://pkg.go.dev/github.com/gogf/gf/v2/database/gdb
由于方法比较简单，这里便不再举例说明。需要注意的是两个方法 Record.Map 及 Result.List，这两个方法也是使用比较频繁的方法，用以将 ORM 查询结果信息转换为可做展示的数据类型。由于结果集字段值底层为 []byte 类型，虽然使用了新的 Value 类型做了封装，并且也提供了数十种常见的类型转换方法（具体请阅读 泛型类型-gvar 章节），但是大多数时候需要直接将结果 Result 或者 Record 直接作为 json 或者 xml 数据结构返回，就需要做转换才行。
使用示例：
package main
import (
"database/sql"
"github.com/gogf/gf/v2/frame/g"
"github.com/gogf/gf/v2/os/gctx"
)
type User struct {
Uid int
Name string
Site string
}
func main() {
var (
user []*User
ctx = gctx.New()
)
err := g.DB().Model("user").Where("uid", 1).Scan(&user)
if err != nil && err != sql.ErrNoRows {
g.Log().Header(false).Fatal(ctx, err)
}
if user != nil {
g.Log().Header(false).Print(ctx, user)
}
}执行后，输出结果为：
[{"Uid":1,"Name":"john","Site":"https://goframe.org"}]