gdb
模块支持对数据记录的写入、更新、删除时间自动填充,提高开发维护效率。为了便于时间字段名称、类型的统一维护,如果使用该特性,我们约定:
- 字段应当设置允许值为
null
。 - 字段的类型必须为时间类型,如:
date
,datetime
,timestamp
。不支持数字类型字段,如int
。 - 字段的名称不支持自定义设置,并且固定名称约定为:
updated_at
用于记录修改时更新,每次记录变更时更新。deleted_at
用于记录的软删除特性,只有当记录删除时会写入一次。
字段名称其实不区分大小写,也会忽略特殊字符,例如CreatedAt
, UpdatedAt
, DeletedAt
也是支持的。此外,时间字段名称可以通过配置文件进行自定义修改,并可使用TimeMaintainDisabled
配置完整关闭该特性,具体请参考 ORM使用配置 章节。
对时间类型的固定其实是为了形成一种规范。
当数据表包含、updated_at
、deleted_at
任意一个或多个字段时,该特性自动启用。
在执行Insert/InsertIgnore/BatchInsert/BatchInsertIgnore
方法时自动写入该时间,随后保持不变。
需要注意的是Replace
方法也会更新该字段,因为该操作相当于删除已存在的旧数据并重新写一条数据。
在执行Insert/InsertIgnore/BatchInsert/BatchInsertIgnore
方法时自动写入该时间,在执行Save/Update
时更新该时间(注意当写入数据存在时会更新updated_at
时间,不会更新created_at
时间)。
// UPDATE `user` SET `name`='john guo',`updated_at`='2020-06-06 21:00:00' WHERE name='john'
db.Model("user").Data(g.Map{"name" : "john guo"}).Where("name", "john").Update()
// UPDATE `user` SET `status`=1,`updated_at`='2020-06-06 21:00:00' ORDER BY `login_time` asc LIMIT 10
db.Model("user").Data("status", 1).Order("login_time asc").Limit(10).Update()
db.Model("user").Data(g.Map{"id": 1, "name": "john guo"}).Save()
需要注意的是Replace
方法也会更新该字段,因为该操作相当于删除已存在的旧数据并重新写一条数据。
查询的时候会发生一些变化,例如:
// SELECT * FROM `user` WHERE uid>1 AND `deleted_at` IS NULL
db.Model("user").Where("uid>?", 1).All()
可以看到当数据表中存在deleted_at
字段时,所有涉及到该表的查询操作都将自动加上deleted_at IS NULL
的条件
如果关联查询的几个表都启用了软删除特性时,会发生以下这种情况,即条件语句中会增加所有相关表的软删除时间判断。
Unscoped
忽略时间特性
Unscoped
用于在链式操作中忽略自动时间更新特性,例如上面的示例,加上Unscoped
方法后:
// SELECT * FROM `user` WHERE uid>1
db.Model("user").Unscoped().Where("uid>?", 1).All()
// SELECT * FROM `user` AS `u` LEFT JOIN `user_detail` AS `ud` ON (ud.uid=u.uid) WHERE u.uid=10 LIMIT 1
db.Model("user", "u").LeftJoin("user_detail", "ud", "ud.uid=u.uid").Where("u.uid", 10).Unscoped().One()