Sequelize 中文文档 v4 - Getting started - 入门

Getting started - 入门

此系列文章的应用示例已发布于 GitHub: sequelize-docs-Zh-CN. 能够 Fork 帮助改进或 Star 关注更新. 欢迎 Star.

安装

Sequelize 可经过 NPM 和 Yarn 得到。

// 使用 NPM
$ npm install --save sequelize

# 还有如下之一:
$ npm install --save pg pg-hstore
$ npm install --save mysql2
$ npm install --save sqlite3
$ npm install --save tedious // MSSQL

// 使用 Yarn
$ yarn add sequelize

# 还有如下之一:
$ yarn add pg pg-hstore
$ yarn add mysql2
$ yarn add sqlite3
$ yarn add tedious // MSSQL

创建链接

Sequelize将在初始化时设置链接池，因此若是从单个进程链接到数据库，你最好每一个数据库只建立一个实例。 若是要从多个进程链接到数据库，则必须为每一个进程建立一个实例，但每一个实例应具备“最大链接池大小除以实例数”的最大链接池大小。 所以，若是您但愿最大链接池大小为90，而且有3个工做进程，则每一个进程的实例应具备30的最大链接池大小。

const sequelize = new Sequelize('database', 'username', 'password', {
  host: 'localhost',
  dialect: 'mysql'|'sqlite'|'postgres'|'mssql',

  pool: {
    max: 5,
    min: 0,
    idle: 10000
  },

  // 仅限 SQLite
  storage: 'path/to/database.sqlite'
});

// 或者你能够简单地使用 uri 链接
const sequelize = new Sequelize('postgres://user:pass@example.com:5432/dbname');

Sequelize 构造函数能够经过 API reference 得到一整套可用的参数。

测试链接

您可使用 .authenticate() 函数来测试链接。

sequelize
  .authenticate()
  .then(() => {
    console.log('Connection has been established successfully.');
  })
  .catch(err => {
    console.error('Unable to connect to the database:', err);
  });

你的第一个模型

模型使用 sequelize.define('name', {attributes}, {options}) 来定义.

const User = sequelize.define('user', {
  firstName: {
    type: Sequelize.STRING
  },
  lastName: {
    type: Sequelize.STRING
  }
});

// force: true 若是表已经存在，将会丢弃表
User.sync({force: true}).then(() => {
  // 表已建立
  return User.create({
    firstName: 'John',
    lastName: 'Hancock'
  });
});

您能够在 Model API reference 中阅读更多关于建立模型的信息。

你的第一个查询

User.findAll().then(users => {
  console.log(users)
})

您能够在 Data retrieval 上查看更多关于模型的查找器功能,如 .findAll() 。或者在 Querying 上查看如何执行特定查询，如 WHERE 和 JSONB 。

应用全局的模型参数

Sequelize 构造函数使用 define 参数，该参数将用做全部定义模型的默认参数。

const sequelize = new Sequelize('connectionUri', {
  define: {
    timestamps: false // 默认为 true
  }
});

const User = sequelize.define('user', {}); // 时间戳默认为 false
const Post = sequelize.define('post', {}, {
  timestamps: true // 时间戳此时为 false
});

Promise

Sequelize 使用 promise 来控制异步控制流程。 若是你不熟悉 promise 是如何工做的，别担忧，你能够在这里阅读 这里 和 这里。

基本上，一个 promise 表明了某个时候会出现的值 - 这意味着“我保证你会在某个时候给你一个结果或一个错误”。

// 不要这样作
user = User.findOne()

console.log(user.get('firstName'));

_这将永远不可用！_这是由于user是 promise 对象，而不是数据库中的数据行。 正确的方法是：

User.findOne().then(user => {
  console.log(user.get('firstName'));
});

当您的环境或解释器支持 async/await 时，这将可用，但只能在 async 方法体中：

user = await User.findOne()

console.log(user.get('firstName'));

一旦知道了什么是 promise 以及它们的工做原理，请使用 bluebird API reference 做为转移工具。 尤为是，你可能会使用不少 .all 。

若是这篇文章对您有帮助, 感谢 下方点赞 或 Star GitHub: sequelize-docs-Zh-CN 支持, 谢谢.