Sequelize官方GitHub：https://github.com/sequelize/sequelize
Sequelize官方中文文档：https://github.com/demopark/sequelize-docs-Zh-CN
Sequelize官方英文文档：http://docs.sequelizejs.com/

Upgrade to V4 - 升级到 V4

Sequelize v4 是当前版本，它引入了一些突破性的变化。 大量的 sequelize 代码库已用 ES2015 功能重构。 以下指南列出了从 v3 升级到 v4 的一些更改。

更新记录

v4 的完整 更新记录.

突破性变化

Node

要使用新的 ES2015 功能，Sequelize v4 至少需要 Node v4 或更高版本。

概括

• Counter Cache 插件以及因此关联的 counterCache 选项已被删除。
• 现在删除了 MariaDB 方言。 这只是 MySQL 的一个简单封装。你可以设置dialect: 'mysql' Sequelize 应该能够与 MariaDB 服务器一起工作。
• Model.Instance 和 instance.Model 被删除。 要从实例访问模型，只需使用 instance.constructor. 实例类 (Model.Instance) 现在是模型本身。
• Sequelize现在使用 bluebird 库的独立副本。
• 由 sequelize 返回的 Promises 现在是 Sequelize.Promise 的实例，而不是全局 bluebird Promise 的实例。
• 池库更新到 v3，现在您需要调用 sequelize.close() 关闭池。

配置 / 参数

• 删除了对旧连接池配置关键字的支持。

  以前

    pool: {
      maxIdleTime: 30000,
      minConnections: 20,
      maxConnections: 30
    }
  

  现在

    pool: {
      idle: 30000,
      min: 20,
      max: 30
    }
  

• 删除了对 pool:false 的支持。 要使用单个连接，请将 pool.max 设置为 1。

• 移除对 referencesKey 的支持，使用引用对象

    references: {
      key: '',
      model: ''
    }
  

• 从sequelize.define 中删除了 classMethods 和 instanceMethods 选项。 Sequelize 模型现在是ES6类。 你可以像这样设置类/实例级别的方法

  以前

  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 () {..}
  

• options.order 现在只接受数组类型或 Sequelize 方法的值。 支持的字符串值（即{order：'name DESC'}）已被弃用。

• 通过 BelongsToMany 关系，add / set / create 设置器现在通过将属性设置为options.through来设置属性。 (先前的第二个参数被用作 through 属性，现在认为 through 是一个子选项的参数)

• Raw 参数 where, order 和 group 如 where: { $raw: '..', order: [{ raw: '..' }], group: [{ raw: '..' }] } 已被删除，以防止SQL注入攻击

  以前

  user.addProject(project, { status: 'started' });
  

  现在

  user.addProject(project, { through: { status: 'started' } });
  

数据类型

• (MySQL/Postgres) BIGINT 现在作为字符串返回
• (MySQL/Postgres) DECIMAL 和 NEWDECIMAL 类型现在作为字符串返回
• (MSSQL) 在 MSSQL 的情况下，DataTypes.DATE 现在使用 DATETIMEOFFSET 而不是 DATETIME2 sql 数据类型来记录时区. 将现有的 DATETIME2 列迁移到 DATETIMEOFFSET, 查看 #7201.
• DATEONLY 现在以 YYYY-MM-DD 格式而不是 Date 类型返回字符串

事务 / CLS

• 删除了 autocommit: true 默认值，显式设置这个选项来让事务自动提交。

• 删除了默认的 REPEATABLE_READ 事务隔离。 现在隔离级别默认为数据库的隔离级别。 在启动事务时显式传递所需的隔离级别。

• CLS补丁不会影响全局 bluebird 的 promise。 使用 Promise.all 和其他 bluebird 方法时，事务不会自动传递给方法。 明确地修补 bluebird 实例以使 CLS 与 bluebird 方法一起工作。

  $ npm install --save cls-bluebird
  

  const Sequelize = require('sequelize');
  const Promise = require('bluebird');
  const clsBluebird = require('cls-bluebird');
  const cls = require('continuation-local-storage');
  
  const ns = cls.createNamespace('transaction-namespace');
  clsBluebird(ns, Promise);
  
  Sequelize.useCLS(ns);
  

原始查询

• Sequelize 现在支持所有方言的绑定参数。 如果方言不支持绑定，在v3 bind 选项将回退到 replacements。 这可能是MySQL / MSSQL的重大改变，现在查询实际上将使用绑定参数而不是替换回退。

其它

• Sequelize.Validator 现在是 validator 库的独立副本。

• Model.validate 实例方法现在默认运行验证 hook。 以前你需要传递 {hooks：true}。 你可以通过传递 {hooks：false} 来覆盖这个行为。

• 当验证失败时，由 Model.validate 实例方法产生的 promise 将被拒绝。 它将在验证成功时完成。

• Sequelize.Utils不再是公共 API 的一部分，使用它需要您自担风险。

• Hooks 现在应该返回 Promises。 回调已被弃用。

• Getters 不会运行 instance.get({raw：true})，而使用instance.get({plain：true})

• include 中的 required 不会传播到 include 链中。

  要获得 v3 兼容的效果，您需要在包含include上设置 required。

  以前

  user.findOne({
    include: {
      model: project,
      include: {
        model: task,
        required: true
      }
    }
  });
  

  现在

  User.findOne({
    include: {
      model: Project,
      required: true,
      include: {
        model: Task,
        required: true
      }
    }
  });
  
  User.findOne({
    include: {
      model: Project,
      required: true,
      include: {
        model: Task,
        where: { type: 'important' } // 其中 required 需要默认为 true
      }
    }
  });
  

或者，您可以添加 beforeFind hook 以获得 v3 兼容的行为 -

function propagateRequired(modelDescriptor) {
  let include = modelDescriptor.include;

  if (!include) return false;
  if (!Array.isArray(include)) include = [include];

  return include.reduce((isRequired, descriptor) => {
    const hasRequiredChild = propogateRequired(descriptor);
    if ((descriptor.where || hasRequiredChild) && descriptor.required === undefined) {
      descriptor.required = true;
    }
    return descriptor.required || isRequired;
  }, false);
}

const sequelize = new Sequelize(..., {
  ...,
  define: {
    hooks: {
      beforeFind: propagateRequired
    }
  }
});