Sequelize 使用问题总结-JavaScript中文网-JavaScript教程资源分享门户

Sequelize 是一个 Node.js ORM(Object-Relational Mapping) 框架，在 Node.js 应用中负责管理数据库的操作，支持多种 SQL 数据库，如 MySQL, PostgreSQL, SQLite 等等。该框架采用 Promise 和 async/await 的方式为开发者提供了更加简单、直观的数据库操作 API，但是在使用过程中，也存在一些问题，本文将从以下几个方面展开讨论：

连接数据库问题
模型定义问题
关联及事务问题
性能问题

连接数据库问题

当使用 Sequelize 连接数据库时，需要调用 sequelize.connect() 方法。但是，一些开发者会遇到连接数据库失败的问题，这是由于 Sequelize 默认使用 Promise 进行连接数据库，只有 Promise 状态为 reject 时，才会抛出错误。应该在 sequelize.connect() 方法外面使用 try...catch，以便在连接失败时能够获取相关错误信息，如下所示：

// www.javascriptcn.com code example
const Sequelize = require('sequelize');
const sequelize = new Sequelize('database', 'username', 'password', {
  host: 'localhost',
  dialect: 'mysql', // 数据库类型
  pool: {
    max: 5,
    min: 0,
    idle: 10000
  }
});

async function connectDB() {
  try {
    await sequelize.authenticate();
    console.log('Connection has been established successfully.');
  } catch (error) {
    console.error('Unable to connect to the database:', error);
  }
}

connectDB();

模型定义问题

模型是 Sequelize 中的核心概念之一，它表达了数据在数据库中的结构。在定义模型时，需要使用 Sequelize.define() 方法，该方法接收两个参数，第一个参数是模型名称，第二个参数是模型字段。但是，一些开发者在定义模型时，会遇到下面几个问题：

模型名称不能包含下划线

模型名称不能包含下划线，否则会出现 “Unknown column XXX in XXX” 的错误。

// 错误示范
const User_Profile = sequelize.define('User_Profile', {...});

模型字段不能定义 set 和 get 方法

模型字段不能定义 set 和 get 方法，否则会出现 “Field 'XXX' doesn't have a default value” 的错误。

// www.javascriptcn.com code example
// 错误示范
const User = sequelize.define('User', {
  username: {
    type: Sequelize.STRING,
    set: function (value) {
      this.setDataValue('username', value.toUpperCase());
    },
    get: function () {
      return this.getDataValue('username').toLowerCase();
    }
  }
});

定义字符类型字段时需指定长度

定义字符类型字段时，如果不指定长度，则会采用默认值 255。

// 正确示范
const User = sequelize.define('User', {
  username: {
    type: Sequelize.STRING(32)
  }
});

关联及事务问题

关联及事务是 Sequelize 的核心功能，下面将针对这两个方面的常见问题进行探讨。

查询关联数据时需要使用 include

在查询关联数据时，需要使用 include。否则查询出来的结果只有主表的数据，而没有关联表的数据。如下所示，查询用户信息时需要同时查询用户的文章信息：

User.findByPk(1, {
  include: [
    {model: Article}
  ]
}).then(user => {
  console.log(user.articles);
});

批量创建对象时使用事务

当需要批量创建多个对象时，需要使用事务，否则在某个对象创建失败时，已经创建成功的对象也无法回滚。如下所示，批量创建用户时需要使用事务：

// www.javascriptcn.com code example
const users = [{name: '张三'}, {name: '李四'}, {name: '王五'}];
const t = await sequelize.transaction();
try {
  const result = await User.bulkCreate(users, {transaction: t});
  await t.commit();
  console.log(result.length + ' rows inserted');
} catch (error) {
  await t.rollback();
  console.error('Transaction has been rolled back due to an error:', error);
}

性能问题

在性能优化方面，Sequelize 也存在一些问题，下面将针对两个方面的常见问题进行探讨。

查询时自动匹配所有字段

当查询数据时，Sequelize 会自动将所有字段都进行匹配，这会导致查询性能下降。可以通过在查询中指定 attributes 字段，来限制查询的字段。如下所示，查询用户信息时只查询 name 与 age 字段：

User.findAll({
  attributes: ['name', 'age']
})

批量更新对象时使用事务

当需要批量更新多个对象时，需要使用事务，否则在某个对象更新失败时，已经更新成功的对象也无法回滚，效率低下。如下所示，批量更新用户时需要使用事务：

const result = await sequelize.transaction(async t => {
  const updatedRows = await User.update({age: 21}, {
    where: {city: '北京'},
    transaction: t
  });
  console.log(updatedRows[0] + ' rows updated');
  return updatedRows;
});

综上所述，本文围绕连接数据库、模型定义、关联及事务、性能优化等四个方面，对 Sequelize 的使用问题进行了详细的探讨，希望对正在使用 Sequelize 的开发者提供参考帮助。

来源：JavaScript中文网，转载请注明来源 https://www.javascriptcn.com/post/67d6879da941bf7134c50041

Sequelize 使用问题总结