这将会保存要传递的数据库凭据并提供所有进一步的方法。

此外,你还可以指定非默认的主机或端口:

  1. dialect: 'mysql',
  2. host: "my.server.tld",
  3. port: 9821,
  4. })

如果你没有密码:

  1. const sequelize = new Sequelize({
  2. database: 'db_name',
  3. username: 'username',
  4. password: null,
  5. dialect: 'mysql'
  6. });

你也可以使用连接字符串:

  1. const sequelize = new Sequelize('mysql://user:pass@example.com:9821/db_name', {
  2. // 更多选项请看下一节
  3. })

除了主机和端口,Sequelize 还提供了一大堆选项。它们在这:

提示: 你可以通过传递一个方法为日志部分设置一个自定义方法。第一个参数是将被记录的字符串 。

Sequelize 支持读取复制,即在要执行 SELECT 查询时可以连接到多个服务器。 当你读取复制时,你指定一个或多个服务器作为读取副本,一个服务器充当写入主机,它处理所有写入和更新,并将其传播到副本(请注意,实际的复制进程为 不是 由 Sequelize 处理,而应该在后端数据库中设置)。

  1. const sequelize = new Sequelize('database', null, null, {
  2. dialect: 'mysql',
  3. port: 3306
  4. replication: {
  5. read: [
  6. { host: '8.8.8.8', username: 'read-username', password: 'some-password' },
  7. { host: '9.9.9.9', username: 'another-username', password: null }
  8. ],
  9. write: { host: '1.1.1.1', username: 'write-username', password: 'any-password' }
  10. },
  11. pool: { // 如果要覆盖用于读写池的选项,可以在此处进行
  12. max: 20,
  13. idle: 30000
  14. },
  15. })

Sequelize使用池来管理到副本的连接。内部 Sequelize 将维护用 pool 配置创建的两个池。

如果要修改这些,可以在实例化 Sequelize 时作为选项传递池,如上所示。

每个 writeuseMaster:true 查询将使用写入池。 对于SELECT,将使用读取池。 只读副本使用基本的循环调度进行切换。

随着 Sequelize 1.6.0 的发布,库可以独立于特定的方言。这意味着您必须自己添加相应的连接器库到您的项目。

为了使 Sequelize 与 MySQL 完美结合,您需要安装 mysql2@^1.0.0-rc.10 或更高版本。 一旦完成,你可以这样使用它:

  1. dialect: 'mysql'
  2. })

注意: 您可以通过设置 dialectOptions 参数将选项直接传递给方言库. 查看
获取例子 (目前只支持mysql).

对于 SQLite 兼容性,您将需要 sqlite3 @〜3.0.0。 配置 Sequelize 如下所示:

  1. const sequelize = new Sequelize('database', 'username', 'password', {
  2. // 设置成 sqlite
  3. dialect: 'sqlite',
  4. // sqlite 的存储引擎
  5. // - default ':memory:'
  6. storage: 'path/to/database.sqlite'
  7. })

PostgreSQL 的库是 pg@^5.0.0 || ^6.0.0 你只需要定义方言:

  1. const sequelize = new Sequelize('database', 'username', 'password', {
  2. // 定义为 postgres
  3. dialect: 'postgres'
  4. })

MSSQL 的库是 tedious@^1.7.0 你只需要定义方言:

  1. const sequelize = new Sequelize('database', 'username', 'password', {
  2. dialect: 'mssql'
  3. })

由于常常使用简单的方式来执行原始/已经准备好的SQL查询,所以可以使用“sequelize.query”函数。

这是它如何工作的:

  1. // 原始查询的参数
  2. sequelize.query('your query', [, options])
  3. // 简单的例子
  4. sequelize.query("SELECT * FROM myTable").then(myTableRows => {
  5. console.log(myTableRows)
  6. })
  7. // 如果要返回 sequelize 实例,请使用模型选项。
  8. // 这样,你可以轻松地将查询映射到预定义的sequelize模型,例如:
  9. sequelize
  10. .query('SELECT * FROM projects', { model: Projects })
  11. .then(projects => {
  12. // 每个记录现在将映射到项目的模型。
  13. console.log(projects)
  14. })
  15. sequelize
  16. // 用于记录查询的函数(或false)
  17. // 每个发送到服务器的SQL查询都会调用
  18. logging: console.log,
  19. // 如果 plain 是 TRUE ,则 sequelize 将只返回结果集的第一条记录。
  20. // 如果是 FALSE, 则是全部记录。
  21. plain: false,
  22. // 如果你没有查询的模型定义,请将其设置为true。
  23. raw: false,
  24. // 您正在执行的查询类型。 查询类型会影响结果在传回之前的格式。
  25. type: Sequelize.QueryTypes.SELECT
  26. })
  27. // 注意第二个参数为null!
  28. // 即使我们在这里声明一个被调用,raw: true 将取代并返回一个原始对象。
  29. sequelize
  30. .query('SELECT * FROM projects', { raw: true })
  31. .then(projects => {
  32. console.log(projects)
  33. })

查询中的替换可以通过两种不同的方式完成:
使用命名参数(以:开头),或者由未命名的

使用的语法取决于传递给函数的替换选项:

  • 如果一个数组被传递,? 将按照它们在数组中出现的顺序被替换
  • 如果传递一个对象,:key将被该对象的键替换。如果包含在查询中的对象未找到对应的键,则会抛出异常,反之亦然。

注意一点: 如果表的属性名称包含 “ . “,则生成的对象将被嵌套:

  1. sequelize.query('select 1 as `foo.bar.baz`').then(rows => {
  2. console.log(JSON.stringify(rows))
  3. /*
  4. [{
  5. "foo": {
  6. "bar": {
  7. "baz": 1
  8. }
  9. }
  10. }]
  11. */