目錄

創(chuàng)建

創(chuàng)建記錄

默認(rèn)值

擴(kuò)展創(chuàng)建選項(xiàng)

查詢

一般查詢

Where 條件

Not 條件

Or條件

內(nèi)聯(lián)條件

額外查詢選項(xiàng)

FirstOrInit

FirstOrCreate

高級(jí)查詢

Pluck

掃描

鏈?zhǔn)讲僮飨嚓P(guān)

鏈?zhǔn)讲僮?/p>

立即執(zhí)行方法

范圍

多個(gè)立即執(zhí)行方法

更新

更新所有字段

更新修改字段

更新選定字段

無Hooks更新

批量更新

使用SQL表達(dá)式更新

修改Hooks中的值

其它更新選項(xiàng)

刪除

刪除記錄

批量刪除

軟刪除

物理刪

CRUD通常指數(shù)據(jù)庫的增刪改查操作，本文詳細(xì)介紹了如何使用GORM實(shí)現(xiàn)創(chuàng)建、查詢、更新和刪除操作。

本文中的db變量為*gorm.DB對象，例如：

import (
  "github.com/jinzhu/gorm"
  _ "github.com/jinzhu/gorm/dialects/mysql"
)

func main() {
  db, err := gorm.Open("mysql", "user:password@/dbname?charset=utf8&parseTime=True&loc=Local")
  defer db.Close()
  
  // db.Xx
}

創(chuàng)建

創(chuàng)建記錄

首先定義模型：

type User struct {
	ID           int64
	Name         string
	Age          int64
}

使用使用NewRecord()查詢主鍵是否存在，主鍵為空使用Create()創(chuàng)建記錄：

user := User{Name: "q1mi", Age: 18}

db.NewRecord(user) // 主鍵為空返回`true`
db.Create(&user)   // 創(chuàng)建user
db.NewRecord(user) // 創(chuàng)建`user`后返回`false`

默認(rèn)值

可以通過 tag 定義字段的默認(rèn)值，比如：

type User struct {
  ID   int64
  Name string `gorm:"default:'小王子'"`
  Age  int64
}

注意：通過tag定義字段的默認(rèn)值，在創(chuàng)建記錄時(shí)候生成的 SQL 語句會(huì)排除沒有值或值為 零值 的字段。 在將記錄插入到數(shù)據(jù)庫后，Gorm會(huì)從數(shù)據(jù)庫加載那些字段的默認(rèn)值。

舉個(gè)例子：

var user = User{Name: "", Age: 99}
db.Create(&user)

上面代碼實(shí)際執(zhí)行的SQL語句是INSERT INTO users("age") values('99');，排除了零值字段Name，而在數(shù)據(jù)庫中這一條數(shù)據(jù)會(huì)使用設(shè)置的默認(rèn)值小王子作為Name字段的值。

注意：所有字段的零值, 比如0,?"",false或者其它零值，都不會(huì)保存到數(shù)據(jù)庫內(nèi)，但會(huì)使用他們的默認(rèn)值。 如果你想避免這種情況，可以考慮使用指針或?qū)崿F(xiàn)?Scanner/Valuer接口，比如：

使用指針方式實(shí)現(xiàn)零值存入數(shù)據(jù)庫

// 使用指針
type User struct {
  ID   int64
  Name *string `gorm:"default:'小王子'"`
  Age  int64
}
user := User{Name: new(string), Age: 18))}
db.Create(&user)  // 此時(shí)數(shù)據(jù)庫中該條記錄name字段的值就是''

使用Scanner/Valuer接口方式實(shí)現(xiàn)零值存入數(shù)據(jù)庫

// 使用 Scanner/Valuer
type User struct {
	ID int64
	Name sql.NullString `gorm:"default:'小王子'"` // sql.NullString 實(shí)現(xiàn)了Scanner/Valuer接口
	Age  int64
}
user := User{Name: sql.NullString{"", true}, Age:18}
db.Create(&user)  // 此時(shí)數(shù)據(jù)庫中該條記錄name字段的值就是''

擴(kuò)展創(chuàng)建選項(xiàng)

例如PostgreSQL數(shù)據(jù)庫中可以使用下面的方式實(shí)現(xiàn)合并插入, 有則更新, 無則插入。

// 為Instert語句添加擴(kuò)展SQL選項(xiàng)
db.Set("gorm:insert_option", "ON CONFLICT").Create(&product)
// INSERT INTO products (name, code) VALUES ("name", "code") ON CONFLICT;

查詢

一般查詢

// 根據(jù)主鍵查詢第一條記錄
db.First(&user)
 SELECT * FROM users ORDER BY id LIMIT 1;

// 隨機(jī)獲取一條記錄
db.Take(&user)
 SELECT * FROM users LIMIT 1;

// 根據(jù)主鍵查詢最后一條記錄
db.Last(&user)
 SELECT * FROM users ORDER BY id DESC LIMIT 1;

// 查詢所有的記錄
db.Find(&users)
 SELECT * FROM users;

// 查詢指定的某條記錄(僅當(dāng)主鍵為整型時(shí)可用)
db.First(&user, 10)
 SELECT * FROM users WHERE id = 10;

Where 條件

普通SQL查詢

// Get first matched record
db.Where("name = ?", "jinzhu").First(&user)
 SELECT * FROM users WHERE name = 'jinzhu' limit 1;

// Get all matched records
db.Where("name = ?", "jinzhu").Find(&users)
 SELECT * FROM users WHERE name = 'jinzhu';

// <>
db.Where("name <> ?", "jinzhu").Find(&users)
 SELECT * FROM users WHERE name <> 'jinzhu';

// IN
db.Where("name IN (?)", []string{"jinzhu", "jinzhu 2"}).Find(&users)
 SELECT * FROM users WHERE name in ('jinzhu','jinzhu 2');

// LIKE
db.Where("name LIKE ?", "%jin%").Find(&users)
 SELECT * FROM users WHERE name LIKE '%jin%';

// AND
db.Where("name = ? AND age >= ?", "jinzhu", "22").Find(&users)
 SELECT * FROM users WHERE name = 'jinzhu' AND age >= 22;

// Time
db.Where("updated_at > ?", lastWeek).Find(&users)
 SELECT * FROM users WHERE updated_at > '2000-01-01 00:00:00';

// BETWEEN
db.Where("created_at BETWEEN ? AND ?", lastWeek, today).Find(&users)
 SELECT * FROM users WHERE created_at BETWEEN '2000-01-01 00:00:00' AND '2000-01-08 00:00:00';

Struct & Map查詢

// Struct
db.Where(&User{Name: "jinzhu", Age: 20}).First(&user)
 SELECT * FROM users WHERE name = "jinzhu" AND age = 20 LIMIT 1;

// Map
db.Where(map[string]interface{}{"name": "jinzhu", "age": 20}).Find(&users)
 SELECT * FROM users WHERE name = "jinzhu" AND age = 20;

// 主鍵的切片
db.Where([]int64{20, 21, 22}).Find(&users)
 SELECT * FROM users WHERE id IN (20, 21, 22);

提示：當(dāng)通過結(jié)構(gòu)體進(jìn)行查詢時(shí)，GORM將會(huì)只通過非零值字段查詢，這意味著如果你的字段值為0，''，false或者其他零值時(shí)，將不會(huì)被用于構(gòu)建查詢條件，例如：

db.Where(&User{Name: "jinzhu", Age: 0}).Find(&users)
 SELECT * FROM users WHERE name = "jinzhu";

你可以使用指針或?qū)崿F(xiàn) Scanner/Valuer 接口來避免這個(gè)問題.

// 使用指針
type User struct {
  gorm.Model
  Name string
  Age  *int
}

// 使用 Scanner/Valuer
type User struct {
  gorm.Model
  Name string
  Age  sql.NullInt64  // sql.NullInt64 實(shí)現(xiàn)了 Scanner/Valuer 接口
}

Not 條件

作用與 Where 類似的情形如下：

db.Not("name", "jinzhu").First(&user)
 SELECT * FROM users WHERE name <> "jinzhu" LIMIT 1;

// Not In
db.Not("name", []string{"jinzhu", "jinzhu 2"}).Find(&users)
 SELECT * FROM users WHERE name NOT IN ("jinzhu", "jinzhu 2");

// Not In slice of primary keys
db.Not([]int64{1,2,3}).First(&user)
 SELECT * FROM users WHERE id NOT IN (1,2,3);

db.Not([]int64{}).First(&user)
 SELECT * FROM users;

// Plain SQL
db.Not("name = ?", "jinzhu").First(&user)
 SELECT * FROM users WHERE NOT(name = "jinzhu");

// Struct
db.Not(User{Name: "jinzhu"}).First(&user)
 SELECT * FROM users WHERE name <> "jinzhu";

Or條件

db.Where("role = ?", "admin").Or("role = ?", "super_admin").Find(&users)
 SELECT * FROM users WHERE role = 'admin' OR role = 'super_admin';

// Struct
db.Where("name = 'jinzhu'").Or(User{Name: "jinzhu 2"}).Find(&users)
 SELECT * FROM users WHERE name = 'jinzhu' OR name = 'jinzhu 2';

// Map
db.Where("name = 'jinzhu'").Or(map[string]interface{}{"name": "jinzhu 2"}).Find(&users)
 SELECT * FROM users WHERE name = 'jinzhu' OR name = 'jinzhu 2';

內(nèi)聯(lián)條件

作用與Where查詢類似，當(dāng)內(nèi)聯(lián)條件與多個(gè)立即執(zhí)行方法一起使用時(shí), 內(nèi)聯(lián)條件不會(huì)傳遞給后面的立即執(zhí)行方法。

// 根據(jù)主鍵獲取記錄 (只適用于整形主鍵)
db.First(&user, 23)
 SELECT * FROM users WHERE id = 23 LIMIT 1;
// 根據(jù)主鍵獲取記錄, 如果它是一個(gè)非整形主鍵
db.First(&user, "id = ?", "string_primary_key")
 SELECT * FROM users WHERE id = 'string_primary_key' LIMIT 1;

// Plain SQL
db.Find(&user, "name = ?", "jinzhu")
 SELECT * FROM users WHERE name = "jinzhu";

db.Find(&users, "name <> ? AND age > ?", "jinzhu", 20)
 SELECT * FROM users WHERE name <> "jinzhu" AND age > 20;

// Struct
db.Find(&users, User{Age: 20})
 SELECT * FROM users WHERE age = 20;

// Map
db.Find(&users, map[string]interface{}{"age": 20})
 SELECT * FROM users WHERE age = 20;

額外查詢選項(xiàng)

// 為查詢 SQL 添加額外的 SQL 操作
db.Set("gorm:query_option", "FOR UPDATE").First(&user, 10)
 SELECT * FROM users WHERE id = 10 FOR UPDATE;

FirstOrInit

獲取匹配的第一條記錄，否則根據(jù)給定的條件初始化一個(gè)新的對象 (僅支持 struct 和 map 條件)

// 未找到
db.FirstOrInit(&user, User{Name: "non_existing"})
 user -> User{Name: "non_existing"}

// 找到
db.Where(User{Name: "Jinzhu"}).FirstOrInit(&user)
 user -> User{Id: 111, Name: "Jinzhu", Age: 20}
db.FirstOrInit(&user, map[string]interface{}{"name": "jinzhu"})
 user -> User{Id: 111, Name: "Jinzhu", Age: 20}

Attrs

如果記錄未找到，將使用參數(shù)初始化 struct.

// 未找到
db.Where(User{Name: "non_existing"}).Attrs(User{Age: 20}).FirstOrInit(&user)
 SELECT * FROM USERS WHERE name = 'non_existing';
 user -> User{Name: "non_existing", Age: 20}

db.Where(User{Name: "non_existing"}).Attrs("age", 20).FirstOrInit(&user)
 SELECT * FROM USERS WHERE name = 'non_existing';
 user -> User{Name: "non_existing", Age: 20}

// 找到
db.Where(User{Name: "Jinzhu"}).Attrs(User{Age: 30}).FirstOrInit(&user)
 SELECT * FROM USERS WHERE name = jinzhu';
 user -> User{Id: 111, Name: "Jinzhu", Age: 20}

Assign

不管記錄是否找到，都將參數(shù)賦值給 struct.

// 未找到
db.Where(User{Name: "non_existing"}).Assign(User{Age: 20}).FirstOrInit(&user)
 user -> User{Name: "non_existing", Age: 20}

// 找到
db.Where(User{Name: "Jinzhu"}).Assign(User{Age: 30}).FirstOrInit(&user)
 SELECT * FROM USERS WHERE name = jinzhu';
 user -> User{Id: 111, Name: "Jinzhu", Age: 30}

FirstOrCreate

獲取匹配的第一條記錄, 否則根據(jù)給定的條件創(chuàng)建一個(gè)新的記錄 (僅支持 struct 和 map 條件)

// 未找到
db.FirstOrCreate(&user, User{Name: "non_existing"})
 INSERT INTO "users" (name) VALUES ("non_existing");
 user -> User{Id: 112, Name: "non_existing"}

// 找到
db.Where(User{Name: "Jinzhu"}).FirstOrCreate(&user)
 user -> User{Id: 111, Name: "Jinzhu"}

Attrs

如果記錄未找到，將使用參數(shù)創(chuàng)建 struct 和記錄.

 // 未找到
db.Where(User{Name: "non_existing"}).Attrs(User{Age: 20}).FirstOrCreate(&user)
 SELECT * FROM users WHERE name = 'non_existing';
 INSERT INTO "users" (name, age) VALUES ("non_existing", 20);
 user -> User{Id: 112, Name: "non_existing", Age: 20}

// 找到
db.Where(User{Name: "jinzhu"}).Attrs(User{Age: 30}).FirstOrCreate(&user)
 SELECT * FROM users WHERE name = 'jinzhu';
 user -> User{Id: 111, Name: "jinzhu", Age: 20}

Assign

不管記錄是否找到，都將參數(shù)賦值給 struct 并保存至數(shù)據(jù)庫.

// 未找到
db.Where(User{Name: "non_existing"}).Assign(User{Age: 20}).FirstOrCreate(&user)
 SELECT * FROM users WHERE name = 'non_existing';
 INSERT INTO "users" (name, age) VALUES ("non_existing", 20);
 user -> User{Id: 112, Name: "non_existing", Age: 20}

// 找到
db.Where(User{Name: "jinzhu"}).Assign(User{Age: 30}).FirstOrCreate(&user)
 SELECT * FROM users WHERE name = 'jinzhu';
 UPDATE users SET age=30 WHERE id = 111;
 user -> User{Id: 111, Name: "jinzhu", Age: 30}

高級(jí)查詢

子查詢

基于?*gorm.expr?的子查詢

db.Where("amount > ?", db.Table("orders").Select("AVG(amount)").Where("state = ?", "paid").SubQuery()).Find(&orders)
// SELECT * FROM "orders"  WHERE "orders"."deleted_at" IS NULL AND (amount > (SELECT AVG(amount) FROM "orders"  WHERE (state = 'paid')));

選擇字段

Select，指定你想從數(shù)據(jù)庫中檢索出的字段，默認(rèn)會(huì)選擇全部字段。

db.Select("name, age").Find(&users)
 SELECT name, age FROM users;

db.Select([]string{"name", "age"}).Find(&users)
 SELECT name, age FROM users;

db.Table("users").Select("COALESCE(age,?)", 42).Rows()
 SELECT COALESCE(age,'42') FROM users;

排序

Order，指定從數(shù)據(jù)庫中檢索出記錄的順序。設(shè)置第二個(gè)參數(shù) reorder 為?true?，可以覆蓋前面定義的排序條件。

db.Order("age desc, name").Find(&users)
 SELECT * FROM users ORDER BY age desc, name;

// 多字段排序
db.Order("age desc").Order("name").Find(&users)
 SELECT * FROM users ORDER BY age desc, name;

// 覆蓋排序
db.Order("age desc").Find(&users1).Order("age", true).Find(&users2)
 SELECT * FROM users ORDER BY age desc; (users1)
 SELECT * FROM users ORDER BY age; (users2)

數(shù)量

Limit，指定從數(shù)據(jù)庫檢索出的最大記錄數(shù)。

db.Limit(3).Find(&users)
 SELECT * FROM users LIMIT 3;

// -1 取消 Limit 條件
db.Limit(10).Find(&users1).Limit(-1).Find(&users2)
 SELECT * FROM users LIMIT 10; (users1)
 SELECT * FROM users; (users2)

偏移

Offset，指定開始返回記錄前要跳過的記錄數(shù)。

db.Offset(3).Find(&users)
 SELECT * FROM users OFFSET 3;

// -1 取消 Offset 條件
db.Offset(10).Find(&users1).Offset(-1).Find(&users2)
 SELECT * FROM users OFFSET 10; (users1)
 SELECT * FROM users; (users2)

總數(shù)

Count，該 model 能獲取的記錄總數(shù)。

db.Where("name = ?", "jinzhu").Or("name = ?", "jinzhu 2").Find(&users).Count(&count)
 SELECT * from USERS WHERE name = 'jinzhu' OR name = 'jinzhu 2'; (users)
 SELECT count(*) FROM users WHERE name = 'jinzhu' OR name = 'jinzhu 2'; (count)

db.Model(&User{}).Where("name = ?", "jinzhu").Count(&count)
 SELECT count(*) FROM users WHERE name = 'jinzhu'; (count)

db.Table("deleted_users").Count(&count)
 SELECT count(*) FROM deleted_users;

db.Table("deleted_users").Select("count(distinct(name))").Count(&count)
 SELECT count( distinct(name) ) FROM deleted_users; (count)

注意?Count?必須是鏈?zhǔn)讲樵兊淖詈笠粋€(gè)操作 ，因?yàn)樗鼤?huì)覆蓋前面的?SELECT，但如果里面使用了?count?時(shí)不會(huì)覆蓋

Group & Having

rows, err := db.Table("orders").Select("date(created_at) as date, sum(amount) as total").Group("date(created_at)").Rows()
for rows.Next() {
  ...
}

// 使用Scan將多條結(jié)果掃描進(jìn)事先準(zhǔn)備好的結(jié)構(gòu)體切片中
type Result struct {
	Date time.Time
	Total int
}
var rets []Result
db.Table("users").Select("date(created_at) as date, sum(age) as total").Group("date(created_at)").Scan(&rets)

rows, err := db.Table("orders").Select("date(created_at) as date, sum(amount) as total").Group("date(created_at)").Having("sum(amount) > ?", 100).Rows()
for rows.Next() {
  ...
}

type Result struct {
  Date  time.Time
  Total int64
}
db.Table("orders").Select("date(created_at) as date, sum(amount) as total").Group("date(created_at)").Having("sum(amount) > ?", 100).Scan(&results)

連接

Joins，指定連接條件

rows, err := db.Table("users").Select("users.name, emails.email").Joins("left join emails on emails.user_id = users.id").Rows()
for rows.Next() {
  ...
}

db.Table("users").Select("users.name, emails.email").Joins("left join emails on emails.user_id = users.id").Scan(&results)

// 多連接及參數(shù)
db.Joins("JOIN emails ON emails.user_id = users.id AND emails.email = ?", "jinzhu@example.org").Joins("JOIN credit_cards ON credit_cards.user_id = users.id").Where("credit_cards.number = ?", "411111111111").Find(&user)

Pluck

Pluck，查詢 model 中的一個(gè)列作為切片，如果您想要查詢多個(gè)列，您應(yīng)該使用?Scan

var ages []int64
db.Find(&users).Pluck("age", &ages)

var names []string
db.Model(&User{}).Pluck("name", &names)

db.Table("deleted_users").Pluck("name", &names)

// 想查詢多個(gè)字段？ 這樣做：
db.Select("name, age").Find(&users)

掃描

Scan，掃描結(jié)果至一個(gè) struct.

type Result struct {
  Name string
  Age  int
}

var result Result
db.Table("users").Select("name, age").Where("name = ?", "Antonio").Scan(&result)

var results []Result
db.Table("users").Select("name, age").Where("id > ?", 0).Scan(&results)

// 原生 SQL
db.Raw("SELECT name, age FROM users WHERE name = ?", "Antonio").Scan(&result)

鏈?zhǔn)讲僮飨嚓P(guān)

鏈?zhǔn)讲僮?/h3>

Method Chaining，Gorm 實(shí)現(xiàn)了鏈?zhǔn)讲僮鹘涌冢阅憧梢园汛a寫成這樣：

// 創(chuàng)建一個(gè)查詢
tx := db.Where("name = ?", "jinzhu")

// 添加更多條件
if someCondition {
  tx = tx.Where("age = ?", 20)
} else {
  tx = tx.Where("age = ?", 30)
}

if yetAnotherCondition {
  tx = tx.Where("active = ?", 1)
}

在調(diào)用立即執(zhí)行方法前不會(huì)生成Query語句，借助這個(gè)特性你可以創(chuàng)建一個(gè)函數(shù)來處理一些通用邏輯。

立即執(zhí)行方法

Immediate methods ，立即執(zhí)行方法是指那些會(huì)立即生成SQL語句并發(fā)送到數(shù)據(jù)庫的方法, 他們一般是CRUD方法，比如：

Create,?First,?Find,?Take,?Save,?UpdateXXX,?Delete,?Scan,?Row,?Rows…

這有一個(gè)基于上面鏈?zhǔn)椒椒ùa的立即執(zhí)行方法的例子：

tx.Find(&user)

生成的SQL語句如下：

SELECT * FROM users where name = 'jinzhu' AND age = 30 AND active = 1;

范圍

Scopes，Scope是建立在鏈?zhǔn)讲僮鞯幕A(chǔ)之上的。

基于它，你可以抽取一些通用邏輯，寫出更多可重用的函數(shù)庫。

func AmountGreaterThan1000(db *gorm.DB) *gorm.DB {
  return db.Where("amount > ?", 1000)
}

func PaidWithCreditCard(db *gorm.DB) *gorm.DB {
  return db.Where("pay_mode_sign = ?", "C")
}

func PaidWithCod(db *gorm.DB) *gorm.DB {
  return db.Where("pay_mode_sign = ?", "C")
}

func OrderStatus(status []string) func (db *gorm.DB) *gorm.DB {
  return func (db *gorm.DB) *gorm.DB {
    return db.Scopes(AmountGreaterThan1000).Where("status IN (?)", status)
  }
}

db.Scopes(AmountGreaterThan1000, PaidWithCreditCard).Find(&orders)
// 查找所有金額大于 1000 的信用卡訂單

db.Scopes(AmountGreaterThan1000, PaidWithCod).Find(&orders)
// 查找所有金額大于 1000 的 COD 訂單

db.Scopes(AmountGreaterThan1000, OrderStatus([]string{"paid", "shipped"})).Find(&orders)
// 查找所有金額大于 1000 且已付款或者已發(fā)貨的訂單

多個(gè)立即執(zhí)行方法

Multiple Immediate Methods，在 GORM 中使用多個(gè)立即執(zhí)行方法時(shí)，后一個(gè)立即執(zhí)行方法會(huì)復(fù)用前一個(gè)立即執(zhí)行方法的條件 (不包括內(nèi)聯(lián)條件) 。

db.Where("name LIKE ?", "jinzhu%").Find(&users, "id IN (?)", []int{1, 2, 3}).Count(&count)

生成的 Sql

SELECT * FROM users WHERE name LIKE 'jinzhu%' AND id IN (1, 2, 3)

SELECT count(*) FROM users WHERE name LIKE 'jinzhu%'

更新

更新所有字段

Save()默認(rèn)會(huì)更新該對象的所有字段，即使你沒有賦值。

db.First(&user)

user.Name = "七米"
user.Age = 99
db.Save(&user)

  UPDATE `users` SET `created_at` = '2020-02-16 12:52:20', `updated_at` = '2020-02-16 12:54:55', `deleted_at` = NULL, `name` = '七米', `age` = 99, `active` = true  WHERE `users`.`deleted_at` IS NULL AND `users`.`id` = 1

更新修改字段

如果你只希望更新指定字段，可以使用Update或者Updates

// 更新單個(gè)屬性，如果它有變化
db.Model(&user).Update("name", "hello")
 UPDATE users SET name='hello', updated_at='2013-11-17 21:34:10' WHERE id=111;

// 根據(jù)給定的條件更新單個(gè)屬性
db.Model(&user).Where("active = ?", true).Update("name", "hello")
 UPDATE users SET name='hello', updated_at='2013-11-17 21:34:10' WHERE id=111 AND active=true;

// 使用 map 更新多個(gè)屬性，只會(huì)更新其中有變化的屬性
db.Model(&user).Updates(map[string]interface{}{"name": "hello", "age": 18, "active": false})
 UPDATE users SET name='hello', age=18, active=false, updated_at='2013-11-17 21:34:10' WHERE id=111;

// 使用 struct 更新多個(gè)屬性，只會(huì)更新其中有變化且為非零值的字段
db.Model(&user).Updates(User{Name: "hello", Age: 18})
 UPDATE users SET name='hello', age=18, updated_at = '2013-11-17 21:34:10' WHERE id = 111;

// 警告：當(dāng)使用 struct 更新時(shí)，GORM只會(huì)更新那些非零值的字段
// 對于下面的操作，不會(huì)發(fā)生任何更新，"", 0, false 都是其類型的零值
db.Model(&user).Updates(User{Name: "", Age: 0, Active: false})

更新選定字段

如果你想更新或忽略某些字段，你可以使用?Select，Omit

db.Model(&user).Select("name").Updates(map[string]interface{}{"name": "hello", "age": 18, "active": false})
 UPDATE users SET name='hello', updated_at='2013-11-17 21:34:10' WHERE id=111;

db.Model(&user).Omit("name").Updates(map[string]interface{}{"name": "hello", "age": 18, "active": false})
 UPDATE users SET age=18, active=false, updated_at='2013-11-17 21:34:10' WHERE id=111;

無Hooks更新

上面的更新操作會(huì)自動(dòng)運(yùn)行 model 的?BeforeUpdate,?AfterUpdate?方法，更新?UpdatedAt?時(shí)間戳, 在更新時(shí)保存其?Associations, 如果你不想調(diào)用這些方法，你可以使用?UpdateColumn，?UpdateColumns

// 更新單個(gè)屬性，類似于 `Update`
db.Model(&user).UpdateColumn("name", "hello")
 UPDATE users SET name='hello' WHERE id = 111;

// 更新多個(gè)屬性，類似于 `Updates`
db.Model(&user).UpdateColumns(User{Name: "hello", Age: 18})
 UPDATE users SET name='hello', age=18 WHERE id = 111;

批量更新

批量更新時(shí)Hooks（鉤子函數(shù)）不會(huì)運(yùn)行。

db.Table("users").Where("id IN (?)", []int{10, 11}).Updates(map[string]interface{}{"name": "hello", "age": 18})
 UPDATE users SET name='hello', age=18 WHERE id IN (10, 11);

// 使用 struct 更新時(shí)，只會(huì)更新非零值字段，若想更新所有字段，請使用map[string]interface{}
db.Model(User{}).Updates(User{Name: "hello", Age: 18})
 UPDATE users SET name='hello', age=18;

// 使用 `RowsAffected` 獲取更新記錄總數(shù)
db.Model(User{}).Updates(User{Name: "hello", Age: 18}).RowsAffected

使用SQL表達(dá)式更新

先查詢表中的第一條數(shù)據(jù)保存至user變量。

var user User
db.First(&user)

db.Model(&user).Update("age", gorm.Expr("age * ? + ?", 2, 100))
 UPDATE `users` SET `age` = age * 2 + 100, `updated_at` = '2020-02-16 13:10:20'  WHERE `users`.`id` = 1;

db.Model(&user).Updates(map[string]interface{}{"age": gorm.Expr("age * ? + ?", 2, 100)})
 UPDATE "users" SET "age" = age * '2' + '100', "updated_at" = '2020-02-16 13:05:51' WHERE `users`.`id` = 1;

db.Model(&user).UpdateColumn("age", gorm.Expr("age - ?", 1))
 UPDATE "users" SET "age" = age - 1 WHERE "id" = '1';

db.Model(&user).Where("age > 10").UpdateColumn("age", gorm.Expr("age - ?", 1))
 UPDATE "users" SET "age" = age - 1 WHERE "id" = '1' AND quantity > 10;

修改Hooks中的值

如果你想修改?BeforeUpdate,?BeforeSave?等 Hooks 中更新的值，你可以使用?scope.SetColumn, 例如：

func (user *User) BeforeSave(scope *gorm.Scope) (err error) {
  if pw, err := bcrypt.GenerateFromPassword(user.Password, 0); err == nil {
    scope.SetColumn("EncryptedPassword", pw)
  }
}

其它更新選項(xiàng)

// 為 update SQL 添加其它的 SQL
db.Model(&user).Set("gorm:update_option", "OPTION (OPTIMIZE FOR UNKNOWN)").Update("name", "hello")
 UPDATE users SET name='hello', updated_at = '2013-11-17 21:34:10' WHERE id=111 OPTION (OPTIMIZE FOR UNKNOWN);

刪除

刪除記錄

警告?刪除記錄時(shí)，請確保主鍵字段有值，GORM 會(huì)通過主鍵去刪除記錄，如果主鍵為空，GORM 會(huì)刪除該 model 的所有記錄。

// 刪除現(xiàn)有記錄
db.Delete(&email)
 DELETE from emails where id=10;

// 為刪除 SQL 添加額外的 SQL 操作
db.Set("gorm:delete_option", "OPTION (OPTIMIZE FOR UNKNOWN)").Delete(&email)
 DELETE from emails where id=10 OPTION (OPTIMIZE FOR UNKNOWN);

批量刪除

刪除全部匹配的記錄

db.Where("email LIKE ?", "%jinzhu%").Delete(Email{})
 DELETE from emails where email LIKE "%jinzhu%";

db.Delete(Email{}, "email LIKE ?", "%jinzhu%")
 DELETE from emails where email LIKE "%jinzhu%";

軟刪除

如果一個(gè) model 有?DeletedAt?字段，他將自動(dòng)獲得軟刪除的功能！ 當(dāng)調(diào)用?Delete?方法時(shí)， 記錄不會(huì)真正的從數(shù)據(jù)庫中被刪除， 只會(huì)將DeletedAt?字段的值會(huì)被設(shè)置為當(dāng)前時(shí)間

db.Delete(&user)
 UPDATE users SET deleted_at="2013-10-29 10:23" WHERE id = 111;

// 批量刪除
db.Where("age = ?", 20).Delete(&User{})
 UPDATE users SET deleted_at="2013-10-29 10:23" WHERE age = 20;

// 查詢記錄時(shí)會(huì)忽略被軟刪除的記錄
db.Where("age = 20").Find(&user)
 SELECT * FROM users WHERE age = 20 AND deleted_at IS NULL;

// Unscoped 方法可以查詢被軟刪除的記錄
db.Unscoped().Where("age = 20").Find(&users)
 SELECT * FROM users WHERE age = 20;

物理刪除

// Unscoped 方法可以物理刪除記錄
db.Unscoped().Delete(&order)
 DELETE FROM orders WHERE id=10;