Sequelize 中文文档 v4 - Upgrade to V4 - 升级到 V4
文章目录
Upgrade to V4 - 升级到 V4
此系列文章的应用示例已发布于 GitHub: sequelize-docs-Zh-CN. 可以 Fork 帮助改进或 Star 关注更新. 欢迎 Star.
Sequelize V4 是一个重要版本,它引入了新的功能和突破性的变化。 大量的 sequelize 代码库已用 ES2015 功能重构。 以下指南列出了从 v3 升级到 v4 的一些更改。查看 修改日志 查看全部详细列表。
突破性变化
- Node 版本: 要使用新的 ES2015 功能,我们现在至少需要 Node4。从现在开始,我们将支持所有当前的LTS版本的Node。
- 计数器缓存插件以及因此关联的计数器缓存选项已被删除。 使用
afterCreate和afterDelete钩子可以实现相同的行为。 - 删除了MariaDB方言。 这只是围绕 MySQL 的一个浅层包装,所以使用
dialect:'mysql而不是进一步的改变。 - 删除默认的
REPEATABLE_READ事务隔离。 隔离级别现在默认为数据库的级别。 在启动事务时明确地传递所需的隔离级别。 - 删除了对
pool: false的支持。要使用单个连接,请将pool.max设置为1。 - (MySQL)当数字太大时,BIGINT 现在被转换为字符串。
-
删除了对referencesKey的支持,使用了一个引用对象。
references: { key: '', model: '' } -
classMethods和instanceMethods已被移除。
以前:
const Model = sequelize.define('Model', {
...
}, {
classMethods: {
associate: function (model) {...}
},
instanceMethods: {
someMethod: function () { ...}
}
});
现在:
const Model = sequelize.define('Model', {
...
});
// 类方法
Model.associate = function (models) {
...associate the models
};
// 实例方法
Model.prototype.someMethod = function () {..}
-
Model.Instance和instance.Model已被移除。要从一个实例访问模型,只需使用instance.constructor。 示例类 (Model.Instance) 现在是模型本身。 -
Sequelize 现在使用一个 bluebird 库的独立副本.
- sequelize返回的 promise 现在是
Sequelize.Promise而不是 bluebird 的全局Promise实例。 -
CLS 补丁不会影响 bluebird 的全局 promise。当与
Promise.all和其他 bluebird 方法一起使用时,事务不会自动传递给方法。明确地修补 bluebird 实例,可以让 CLS 能够使用 bluebird 方法。$ npm install --save cls-bluebird
- sequelize返回的 promise 现在是
const Promise = require('bluebird');
const Sequelize = require('sequelize');
const cls = require('continuation-local-storage');
const ns = cls.createNamespace('transaction-namespace');
const clsBluebird = require('cls-bluebird');
clsBluebird(ns, Promise);
Sequelize.useCLS(ns);
-
Sequelize.Validator现在是validator库的独立副本 -
DataTypes.DECIMAL对于 MySQL 和 Postgres 返回的是字符串. -
DataTypes.DATE现在使用DATETIMEOFFSET而不是DATETIME2sql数据类型,以防MSSQL记录时区。要将现有的DATETIME2列迁移到DATETIMEOFFSET中, 查看 #7201. -
options.order现在只接受数组类型或 Sequelize 方法的值。 原限支持的字符串值(即{order:'name DESC'})已被弃用。 - 使用
BelongsToMany关系add / set / create设置器现在通过将它们传递为options.through来设置属性(以前的第二个参数被用作通过属性,现在它被认为是through作为子选项的选项)。
以前:
user.addProject(project, { status: 'started' })
现在:
user.addProject(project, { through: { status: 'started' }})
-
DATEONLY现在以YYYY-MM-DD格式而不是Date类型返回字符串 -
Model.validate实例方法默认运行验证钩子。以前你需要传递{ hooks: true }. 您可以通过传递{ hooks: false }来覆盖此行为。 - 当验证失败时,来自
Model.validate实例方法的结果将被拒绝。 验证成功后才能实现。 - 原始参数 where, order 和 group 比如
where: { $raw: '..', order: [{ raw: '..' }], group: [{ raw: '..' }] }删除以防止SQL注入攻击。 -
Sequelize.Utils不再是公共API的一部分,使用它自己承担风险。 -
Hooks现在应返回 promise。 不支持回调。
新功能
-
sequelize.sync({ alter: true })的初始版本已添加,并使用ALTER TABLE命令来同步表。 迁移 仍然是首选,应在生产中使用。 - 现在支持添加和删除数据库约束。 现有的 primary,foreignKey 和其他约束现在可以使用迁移来添加/删除 - 查看更多.
-
实例(数据库行)现在是模型的实例,而不是单独类的实例。这意味着你可以替换
User.build()用new User()和sequelize.define(attributes, options)用class User extends Sequelize.Model {} User.init(attributes, options)
然后,您可以直接在类中定义自定义方法,类方法和 getter / setter。
这也使得有更多的使用模式,例如用 装饰器.
- 增加了
DEBUG支持。 现在可以使用DEBUG = sequelize * node app.js为所有 sequlize 操作启用日志记录。 要过滤记录的查询,请使用DEBUG=sequelize:sql:mssql sequelize:connection*来记录生成的SQL查询,连接信息等。 -
SQLite添加了JSON数据类型支持。 -
UPSERT现在使用MERGE语句支持MSSQL。 - 事务现在完全支持
MSSQL。 -
MSSQL方言现在支持过滤的索引。queryInterface.addIndex( 'Person', ['firstname', 'lastname'], { where: { lastname: { $ne: null } } } )
如果这篇文章对您有帮助, 感谢 下方点赞 或 Star GitHub: sequelize-docs-Zh-CN 支持, 谢谢.

评论
登录后参与技术讨论,分享你的经验与见解。
登录 / 注册暂无评论