1. 更新

1.1. 更新所有字段

Save 方法在执行 SQL 更新操作时将包含所有字段，即使这些字段没有被修改。

  1. db.First(&user)
  3. user.Name = "jinzhu 2"
  4. user.Age = 100
  5. db.Save(&user)
  7. //// UPDATE users SET name='jinzhu 2', age=100, birthday='2016-01-01', updated_at = '2013-11-17 21:34:10' WHERE id=111;

1.2. 更新已更改的字段

如果你只想更新已经修改了的字段，可以使用 Update，Updates 方法。

  1. // 如果单个属性被更改了，更新它
  2. db.Model(&user).Update("name", "hello")
  3. //// UPDATE users SET name='hello', updated_at='2013-11-17 21:34:10' WHERE id=111;
  5. // 使用组合条件更新单个属性
  6. db.Model(&user).Where("active = ?", true).Update("name", "hello")
  7. //// UPDATE users SET name='hello', updated_at='2013-11-17 21:34:10' WHERE id=111 AND active=true;
  9. // 使用 `map` 更新多个属性，只会更新那些被更改了的字段
  10. db.Model(&user).Updates(map[string]interface{}{"name": "hello", "age": 18, "actived": false})
  11. //// UPDATE users SET name='hello', age=18, actived=false, updated_at='2013-11-17 21:34:10' WHERE id=111;
  13. // 使用 `struct` 更新多个属性，只会更新那些被修改了的和非空的字段
  14. db.Model(&user).Updates(User{Name: "hello", Age: 18})
  15. //// UPDATE users SET name='hello', age=18, updated_at = '2013-11-17 21:34:10' WHERE id = 111;
  17. // 警告： 当使用结构体更新的时候, GORM 只会更新那些非空的字段
  18. // 例如下面的更新，没有东西会被更新，因为像 "", 0, false 是这些字段类型的空值
  19. db.Model(&user).Updates(User{Name: "", Age: 0, Actived: false})

1.3. 更新选中的字段

如果你在执行更新操作时只想更新或者忽略某些字段，可以使用 Select，Omit方法。

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

1.4. 更新列钩子方法

上面的更新操作更新时会执行模型的 BeforeUpdate 和 AfterUpdate 方法，来更新 UpdatedAt 时间戳，并且保存他的 关联。如果你不想执行这些操作，可以使用 UpdateColumn，UpdateColumns 方法。

  1. // Update single attribute, similar with `Update`
  2. db.Model(&user).UpdateColumn("name", "hello")
  3. //// UPDATE users SET name='hello' WHERE id = 111;
  5. // Update multiple attributes, similar with `Updates`
  6. db.Model(&user).UpdateColumns(User{Name: "hello", Age: 18})
  7. //// UPDATE users SET name='hello', age=18 WHERE id = 111;

1.5. 批量更新

批量更新时，钩子函数不会执行

  1. db.Table("users").Where("id IN (?)", []int{10, 11}).Updates(map[string]interface{}{"name": "hello", "age": 18})
  2. //// UPDATE users SET name='hello', age=18 WHERE id IN (10, 11);
  4. // 使用结构体更新将只适用于非零值，或者使用 map[string]interface{}
  5. db.Model(User{}).Updates(User{Name: "hello", Age: 18})
  6. //// UPDATE users SET name='hello', age=18;
  8. // 使用 `RowsAffected` 获取更新影响的记录数
  9. db.Model(User{}).Updates(User{Name: "hello", Age: 18}).RowsAffected

1.6. 带有表达式的 SQL 更新

  1. DB.Model(&product).Update("price", gorm.Expr("price * ? + ?", 2, 100))
  2. //// UPDATE "products" SET "price" = price * '2' + '100', "updated_at" = '2013-11-17 21:34:10' WHERE "id" = '2';
  4. DB.Model(&product).Updates(map[string]interface{}{"price": gorm.Expr("price * ? + ?", 2, 100)})
  5. //// UPDATE "products" SET "price" = price * '2' + '100', "updated_at" = '2013-11-17 21:34:10' WHERE "id" = '2';
  7. DB.Model(&product).UpdateColumn("quantity", gorm.Expr("quantity - ?", 1))
  8. //// UPDATE "products" SET "quantity" = quantity - 1 WHERE "id" = '2';
  10. DB.Model(&product).Where("quantity > 1").UpdateColumn("quantity", gorm.Expr("quantity - ?", 1))
  11. //// UPDATE "products" SET "quantity" = quantity - 1 WHERE "id" = '2' AND quantity > 1;

1.7. 在钩子函数中更新值

如果你想使用 BeforeUpdate、BeforeSave钩子函数修改更新的值，可以使用 scope.SetColumn方法，例如：

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

1.8. 额外的更新选项

  1. // 在更新 SQL 语句中添加额外的 SQL 选项
  2. db.Model(&user).Set("gorm:update_option", "OPTION (OPTIMIZE FOR UNKNOWN)").Update("name", "hello")
  3. //// UPDATE users SET name='hello', updated_at = '2013-11-17 21:34:10' WHERE id=111 OPTION (OPTIMIZE FOR UNKNOWN);