Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

需要注意,该特性仅对链式操作有效。

时间更新

gdb模块支持对数据记录的写入、更新、删除时间自动填充,提高开发维护效率。为了便于时间字段名称、类型的统一维护,如果使用该特性,我们约定: - 字段应当设置允许值为null。 - 字段的类型必须为时间类型,如:date, datetime, timestamp。暂不支持数字类型字段,如int。 - 字段的名称不支持自定义设置,并且固定名称约定为: - created_at用于记录创建时更新,仅会写入一次。 - updated_at用于记录修改时更新,每次记录变更时更新。 - deleted_at用于记录的软删除特性,只有当记录删除时会写入一次。

字段名称其实不区分大小写,也会忽略特殊字符,例如CreatedAt, UpdatedAt, DeletedAt也是支持的。此外,时间字段名称可以通过配置文件进行自定义修改,具体请参考【ORM使用配置】章节。

v1.14版本开始,默认时间字段名称从create_atupdate_atdelete_at调整为了created_atupdated_atdeleted_at,但旧字段名称也是永久支持。

特性的启用

当数据表包含created_atupdated_atdeleted_at任意一个或多个字段时,该特性自动启用。

以下的示例中,我们默认示例中的数据表均包含了这3个字段。

created_at写入时间

// INSERT INTO `user`(`name`,`created_at`,`updated_at`) VALUES('john', `2020-06-06 21:00:00`, `2020-06-06 21:00:00`)
r, err := db.Table("user").Data(g.Map{"name": "john"}).Insert()
// INSERT IGNORE INTO `user`(`uid`,`name`,`created_at`,`updated_at`) VALUES(10000,'john', `2020-06-06 21:00:00`, `2020-06-06 21:00:00`)
r, err := db.Table("user").Data(g.Map{"uid": 10000, "name": "john"}).InsertIgnore()
// REPLACE INTO `user`(`uid`,`name`,`created_at`,`updated_at`) VALUES(10000,'john', `2020-06-06 21:00:00`, `2020-06-06 21:00:00`)
r, err := db.Table("user").Data(g.Map{"uid": 10000, "name": "john"}).Replace()
// INSERT INTO `user`(`uid`,`name`,`created_at`,`updated_at`) VALUES(10001,'john', `2020-06-06 21:00:00`, `2020-06-06 21:00:00`) ON DUPLICATE KEY UPDATE `uid`=VALUES(`uid`),`name`=VALUES(`name`),`updated_at`=VALUES(`updated_at`)
r, err := db.Table("user").Data(g.Map{"uid": 10001, "name": "john"}).Save()

updated_at更新时间

// UPDATE `user` SET `name`='john guo',`updated_at`='2020-06-06 21:00:00' WHERE name='john'
r, err := db.Table("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
r, err := db.Table("user").Data("status", 1).Order("login_time asc").Limit(10).Update()

deleted_at数据软删除

软删除会稍微比较复杂一些,当软删除存在时,所有的查询语句都将会自动加上deleted_at的条件。

...

可以看到当数据表中存在deleted_at字段时,所有涉及到该表的查询操作都将自动加上deleted_at IS NULL的条件

联表查询的场景

如果关联查询的几个表都启用了软删除特性时,会发生以下这种情况,即条件语句中会增加所有相关表的软删除时间判断。

// SELECT * FROM `user` AS `u` LEFT JOIN `user_detail` AS `ud` ON (ud.uid=u.uid) WHERE u.uid=10 AND `u`.`deleted_at` IS NULL AND `ud`.`deleteat` IS NULL LIMIT 1
r, err := db.Table("user", "u").LeftJoin("user_detail", "ud", "ud.uid=u.uid").Where("u.uid", 10).One()

Unscoped忽略软删除

Unscoped用于在链式操作中忽略软删除时间条件,例如上面的示例,加上Unscoped方法后:

...