Paranoid - 偏执表

Sequelize 支持 paranoid 表的概念. 一个 paranoid 表是一个被告知删除记录时不会真正删除它的表.反而一个名为 deletedAt 的特殊列会将其值设置为该删除请求的时间戳.

这意味着偏执表会执行记录的 软删除,而不是 硬删除.

将模型定义为 paranoid

要定义 paranoid 模型,必须将 paranoid: true 参数传递给模型定义. Paranoid 需要时间戳才能起作用(即,如果你传递 timestamps: false 了,paranoid 将不起作用).

你还可以将默认的列名(默认是 deletedAt)更改为其他名称.

  1. class Post extends Model {}
  2. Post.init({ /* 这是属性 */ }, {
  3.   sequelize,
  4.   paranoid: true,
  6.   // 如果要为 deletedAt 列指定自定义名称
  7.   deletedAt: 'destroyTime'
  8. });

删除

当你调用 destroy 方法时,将发生软删除：

  1. await Post.destroy({
  2.   where: {
  3.     id: 1
  4.   }
  5. });
  6. // UPDATE "posts" SET "deletedAt"=[timestamp] WHERE "deletedAt" IS NULL AND "id" = 1

如果你确实想要硬删除,并且模型是 paranoid,则可以使用 force: true 参数强制执行：

  1. await Post.destroy({
  2.   where: {
  3.     id: 1
  4.   },
  5.   force: true
  6. });
  7. // DELETE FROM "posts" WHERE "id" = 1

上面的示例以静态的 destroy 方法为例(Post.destroy),所有实例方法的工作方式相同：

  1. const post = await Post.create({ title: 'test' });
  2. console.log(post instanceof Post); // true
  3. await post.destroy(); // 只设置 `deletedAt` 标志
  4. await post.destroy({ force: true }); // 真的会删除记录

恢复

要恢复软删除的记录,可以使用 restore 方法,该方法在静态版本和实例版本中都提供：

  1. // 展示实例 `restore` 方法的示例
  2. // 我们创建一个帖子,对其进行软删除,然后将其还原
  3. const post = await Post.create({ title: 'test' });
  4. console.log(post instanceof Post); // true
  5. await post.destroy();
  6. console.log('soft-deleted!');
  7. await post.restore();
  8. console.log('restored!');
  10. // 展示静态 `restore` 方法的示例.
  11. // 恢复每个 likes 大于 100 的软删除的帖子
  12. await Post.restore({
  13.   where: {
  14.     likes: {
  15.       [Op.gt]: 100
  16.     }
  17.   }
  18. });

其他查询行为

Sequelize 执行的每个查询将自动忽略软删除的记录(当然,原始查询除外).

这意味着,例如,findAll 方法将看不到软删除的记录,仅获取未删除的记录.

即使你单纯的调用提供了软删除记录主键的findByPk,结果也将是 null,就好像该记录不存在一样.

如果你真的想让查询看到被软删除的记录,可以将 paranoid: false 参数传递给查询方法. 例如：

  1. await Post.findByPk(123); // 如果 ID 123 的记录被软删除,则将返回 `null`
  2. await Post.findByPk(123, { paranoid: false }); // 这将检索记录
  4. await Post.findAll({
  5.   where: { foo: 'bar' }
  6. }); // 这将不会检索软删除的记录
  8. await Post.findAll({
  9.   where: { foo: 'bar' },
  10.   paranoid: false
  11. }); // 这还将检索软删除的记录