当前位置：首页 > article >正文

GORM查询指南：高效检索数据

article 2024/11/12 22:35:09

GORM是Go语言中一个功能丰富的ORM库，它提供了多种灵活的方法来执行数据库查询。在这篇文章中，我们将深入探讨GORM的查询功能，包括如何检索单个对象、根据条件筛选数据、排序、分页以及执行联表查询等。通过这些功能，你可以高效地从数据库中检索所需的数据。

检索单个对象

GORM提供了First、Take和Last方法，用于从数据库中检索单个对象。这些方法在执行查询时会自动添加LIMIT 1条件，如果没有找到记录，则返回ErrRecordNotFound错误。

// 使用First方法检索第一条记录
db.First(&user)

// Take方法与First类似，也是检索第一条记录
db.Take(&user)

// Last方法用于检索最后一条记录
db.Last(&user)

// 检索结果包含影响的行数和错误信息
result := db.First(&user)
result.RowsAffected // 影响的行数
result.Error        // 错误信息

// 检查是否未找到记录
errors.Is(result.Error, gorm.ErrRecordNotFound)

如果你想避免ErrRecordNotFound错误，可以使用Find方法，例如db.Limit(1).Find(&user)。

根据主键检索

如果主键是数字类型，可以使用内联条件来检索对象。当使用字符串作为主键时，需要特别注意避免SQL注入。

// 根据数字主键检索
db.First(&user, 10)

// 根据字符串主键检索
db.First(&user, "id = ?", "1b74413f-f3b8-409f-ac47-e8c062e3472a")

检索全部对象

使用Find方法可以检索表中的所有对象。

// 检索所有用户
result := db.Find(&users)

// 检索结果包含影响的行数和错误信息
result.RowsAffected // 影响的行数
result.Error        // 错误信息

条件查询

GORM支持多种条件查询方式，包括字符串条件、结构体条件和内联条件。

// 字符串条件查询
db.Where("name = ?", "jinzhu").First(&user)

// 结构体条件查询
db.Where(&User{Name: "jinzhu", Age: 20}).First(&user)

// 内联条件查询
db.First(&user, "name = ?", "jinzhu")

选择特定字段

使用Select方法可以指定想要检索的字段。

// 选择特定字段
db.Select("name", "age").Find(&users)

排序

使用Order方法可以指定检索记录的排序方式。

// 根据年龄降序和名字升序排序
db.Order("age desc, name").Find(&users)

Limit & Offset

使用Limit和Offset方法可以进行分页查询。

// 限制返回记录数为3条
db.Limit(3).Find(&users)

// 跳过前3条记录，返回之后的记录
db.Offset(3).Find(&users)

// 组合使用Limit和Offset
db.Limit(10).Offset(5).Find(&users)

Group By & Having

使用Group和Having方法可以对数据进行分组和条件筛选。

// 按名字分组，并筛选分组后年龄总和大于40的组
db.Model(&User{}).Select("name, sum(age) as total").Group("name").Having("sum(age) > ?", 40).Find(&results)

Distinct

使用Distinct方法可以检索不重复的记录。

// 检索不重复的名字和年龄组合
db.Distinct("name", "age").Find(&results)

Joins

使用Joins方法可以执行联表查询。

// 左联用户和邮箱表
db.Model(&User{}).Select("users.name, emails.email").Joins("left join emails on emails.user_id = users.id").Scan(&results)

Scan

使用Scan方法可以将查询结果扫描到结构体中。

// 将查询结果扫描到结构体中
type Result struct {
  Name string
  Age  int
}
var result Result
db.Table("users").Select("name", "age").Where("name = ?", "Antonio").Scan(&result)