使用Sequelize8

本文涉及的产品
RDS MySQL Serverless 基础系列,0.5-2RCU 50GB
云数据库 RDS MySQL,集群系列 2核4GB
推荐场景:
搭建个人博客
RDS MySQL Serverless 高可用系列,价值2615元额度,1个月
简介: 使用Sequelize8

访问MySQL


当我们安装好MySQL后,Node.js程序如何访问MySQL数据库呢?


访问MySQL数据库只有一种方法,就是通过网络发送SQL命令,然后,MySQL服务器执行后返回结果。


我们可以在命令行窗口输入mysql -u root -p,然后输入root口令后,就连接到了MySQL服务器。因为没有指定--host参数,所以我们连接到的是localhost,也就是本机的MySQL服务器。


在命令行窗口下,我们可以输入命令,操作MySQL服务器:


mysql> show databases;
+--------------------+
| Database           |
+--------------------+
| information_schema |
| mysql              |
| performance_schema |
| test               |
+--------------------+
4 rows in set (0.05 sec)


输入exit退出MySQL命令行模式。


对于Node.js程序,访问MySQL也是通过网络发送SQL命令给MySQL服务器。这个访问MySQL服务器的软件包通常称为MySQL驱动程序。不同的编程语言需要实现自己的驱动,MySQL官方提供了Java、.Net、Python、Node.js、C++和C的驱动程序,官方的Node.js驱动目前仅支持5.7以上版本,而我们上面使用的命令行程序实际上用的就是C驱动。


目前使用最广泛的MySQL Node.js驱动程序是开源的mysql,可以直接使用npm安装。



ORM



如果直接使用mysql包提供的接口,我们编写的代码就比较底层,例如,查询代码:


connection.query('SELECT * FROM users WHERE id = ?', ['123'], function(err, rows) {
    if (err) {
        // error
    } else {
        for (let row in rows) {
            processRow(row);
        }
    }
});


考虑到数据库表是一个二维表,包含多行多列,例如一个pets的表:


mysql> select * from pets;
+----+--------+------------+
| id | name   | birth      |
+----+--------+------------+
|  1 | Gaffey | 2007-07-07 |
|  2 | Odie   | 2008-08-08 |
+----+--------+------------+
2 rows in set (0.00 sec)

每一行可以用一个JavaScript对象表示,例如第一行:

{
    "id": 1,
    "name": "Gaffey",
    "birth": "2007-07-07"
}

这就是传说中的ORM技术:Object-Relational Mapping,把关系数据库的表结构映射到对象上。是不是很简单?


但是由谁来做这个转换呢?所以ORM框架应运而生。


我们选择Node的ORM框架Sequelize来操作数据库。这样,我们读写的都是JavaScript对象,Sequelize帮我们把对象变成数据库中的行。


用Sequelize查询pets表,代码像这样:


Pet.findAll()
   .then(function (pets) {
       for (let pet in pets) {
           console.log(`pet.id:{pet.id}: {pet.name}`);
       }
   }).catch(function (err) {
       // error
   });


因为Sequelize返回的对象是Promise,所以我们可以用then()和catch()分别异步响应成功和失败。


但是用then()和catch()仍然比较麻烦。有没有更简单的方法呢?


可以用ES7的await来调用任何一个Promise对象,这样我们写出来的代码就变成了:


var pets = await Pet.findAll();


真的就是这么简单!


await只有一个限制,就是必须在async函数中调用。上面的代码直接运行还差一点,我们可以改成:


(async () => {
    var pets = await Pet.findAll();
})();


考虑到koa的处理函数都是async函数,所以我们实际上将来在koa的async函数中直接写await访问数据库就可以了!


这也是为什么我们选择Sequelize的原因:只要API返回Promise,就可以用await调用,写代码就非常简单!


实战


在使用Sequlize操作数据库之前,我们先在MySQL中创建一个表来测试。我们可以在test数据库中创建一个pets表。test数据库是MySQL安装后自动创建的用于测试的数据库。在MySQL命令行执行下列命令:


grant all privileges on test.* to 'www'@'%' identified by 'www';

use test;

create table pets (
    id varchar(50) not null,
    name varchar(100) not null,
    gender bool not null,
    birth varchar(10) not null,
    createdAt bigint not null,
    updatedAt bigint not null,
    version bigint not null,
    primary key (id)
) engine=innodb;


第一条grant命令是创建MySQL的用户名和口令,均为www,并赋予操作test数据库的所有权限。


第二条use命令把当前数据库切换为test。


第三条命令创建了pets表。


然后,我们根据前面的工程结构创建hello-sequelize工程,结构如下:

hello-sequelize/
|
+- .vscode/
|  |
|  +- launch.json <-- VSCode 配置文件
|
+- init.txt <-- 初始化SQL命令
|
+- config.js <-- MySQL配置文件
|
+- app.js <-- 使用koa的js
|
+- package.json <-- 项目描述文件
|
+- node_modules/ <-- npm安装的所有依赖包


然后,添加如下依赖包:


"sequelize": "3.24.1",
"mysql": "2.11.1"


注意mysql是驱动,我们不直接使用,但是sequelize会用。


用npm install安装。


config.js实际上是一个简单的配置文件:


var config = {
    database: 'test', // 使用哪个数据库
    username: 'www', // 用户名
    password: 'www', // 口令
    host: 'localhost', // 主机名
    port: 3306 // 端口号,MySQL默认3306
};

module.exports = config;


下面,我们就可以在app.js中操作数据库了。使用Sequelize操作MySQL需要先做两件准备工作:


第一步,创建一个sequelize对象实例:


const Sequelize = require('sequelize');
const config = require('./config');

var sequelize = new Sequelize(config.database, config.username, config.password, {
    host: config.host,
    dialect: 'mysql',
    pool: {
        max: 5,
        min: 0,
        idle: 30000
    }
});

第二步,定义模型Pet,告诉Sequelize如何映射数据库表:


var Pet = sequelize.define('pet', {
    id: {
        type: Sequelize.STRING(50),
        primaryKey: true
    },
    name: Sequelize.STRING(100),
    gender: Sequelize.BOOLEAN,
    birth: Sequelize.STRING(10),
    createdAt: Sequelize.BIGINT,
    updatedAt: Sequelize.BIGINT,
    version: Sequelize.BIGINT
}, {
        timestamps: false
    });


用sequelize.define()定义Model时,传入名称pet,默认的表名就是pets。第二个参数指定列名和数据类型,如果是主键,需要更详细地指定。第三个参数是额外的配置,我们传入{ timestamps: false }是为了关闭Sequelize的自动添加timestamp的功能。所有的ORM框架都有一种很不好的风气,总是自作聪明地加上所谓“自动化”的功能,但是会让人感到完全摸不着头脑。


接下来,我们就可以往数据库中塞一些数据了。我们可以用Promise的方式写:

var now = Date.now();

Pet.create({
    id: 'g-' + now,
    name: 'Gaffey',
    gender: false,
    birth: '2007-07-07',
    createdAt: now,
    updatedAt: now,
    version: 0
}).then(function (p) {
    console.log('created.' + JSON.stringify(p));
}).catch(function (err) {
    console.log('failed: ' + err);
});


也可以用await写:


(async () => {
    var dog = await Pet.create({
        id: 'd-' + now,
        name: 'Odie',
        gender: false,
        birth: '2008-08-08',
        createdAt: now,
        updatedAt: now,
        version: 0
    });
    console.log('created: ' + JSON.stringify(dog));
})();


显然await代码更胜一筹。


查询数据时,用await写法如下:


(async () => {
    var pets = await Pet.findAll({
        where: {
            name: 'Gaffey'
        }
    });
    console.log(`find ${pets.length} pets:`);
    for (let p of pets) {
        console.log(JSON.stringify(p));
    }
})();


如果要更新数据,可以对查询到的实例调用save()方法:


(async () => {
    var p = await queryFromSomewhere();
    p.gender = true;
    p.updatedAt = Date.now();
    p.version ++;
    await p.save();
})();


如果要删除数据,可以对查询到的实例调用destroy()方法:


(async () => {
    var p = await queryFromSomewhere();
    await p.destroy();
})();


运行代码,可以看到Sequelize打印出的每一个SQL语句,便于我们查看:


Executing (default): INSERT INTO `pets` (`id`,`name`,`gender`,`birth`,`createdAt`,`updatedAt`,`version`) VALUES ('g-1471961204219','Gaffey',false,'2007-07-07',1471961204219,1471961204219,0);


Model


我们把通过sequelize.define()返回的Pet称为Model,它表示一个数据模型。


我们把通过Pet.findAll()返回的一个或一组对象称为Model实例,每个实例都可以直接通过JSON.stringify序列化为JSON字符串。但是它们和普通JSON对象相比,多了一些由Sequelize添加的方法,比如save()和destroy()。调用这些方法我们可以执行更新或者删除操作。


所以,使用Sequelize操作数据库的一般步骤就是:


首先,通过某个Model对象的findAll()方法获取实例;


如果要更新实例,先对实例属性赋新值,再调用save()方法;


如果要删除实例,直接调用destroy()方法。


注意findAll()方法可以接收where、order这些参数,这和将要生成的SQL语句是对应的。


相关实践学习
如何在云端创建MySQL数据库
开始实验后,系统会自动创建一台自建MySQL的 源数据库 ECS 实例和一台 目标数据库 RDS。
全面了解阿里云能为你做什么
阿里云在全球各地部署高效节能的绿色数据中心,利用清洁计算为万物互联的新世界提供源源不断的能源动力,目前开服的区域包括中国(华北、华东、华南、香港)、新加坡、美国(美东、美西)、欧洲、中东、澳大利亚、日本。目前阿里云的产品涵盖弹性计算、数据库、存储与CDN、分析与搜索、云通信、网络、管理与监控、应用服务、互联网中间件、移动服务、视频服务等。通过本课程,来了解阿里云能够为你的业务带来哪些帮助 &nbsp; &nbsp; 相关的阿里云产品:云服务器ECS 云服务器 ECS(Elastic Compute Service)是一种弹性可伸缩的计算服务,助您降低 IT 成本,提升运维效率,使您更专注于核心业务创新。产品详情: https://www.aliyun.com/product/ecs
相关文章
|
7月前
egg.js 24.10sequelize模型-查询单个
egg.js 24.10sequelize模型-查询单个
56 1
egg.js 24.10sequelize模型-查询单个
|
JavaScript NoSQL MongoDB
100 # mongoose 的使用
100 # mongoose 的使用
67 0
|
存储 前端开发 数据库
electron项目中使用本地数据库sqlite3和sequelize框架
electron项目中使用本地数据库sqlite3和sequelize框架
|
2月前
|
存储 数据库
mongoose
【10月更文挑战第30天】
27 4
|
6月前
|
JavaScript NoSQL 数据库连接
使用Nodejs + express连接数据库mongoose
【6月更文挑战第3天】这篇文章介绍了如何在Express应用中使用Mongoose连接MongoDB数据库。首先,需要创建一个`db.js`文件,然后通过`npm install mongoose`安装Mongoose驱动。接着,在应用中引入MongoDB模块,建立到数据库的连接。创建一个Mongoose schema定义数据模型,如用户信息表。最后,执行数据库操作,包括查询、插入、更新和删除文档,并在完成后关闭数据库连接。文中还提供了相关代码示例。
203 1
|
6月前
|
SQL Go 数据库
XORM 框架的使用
XORM 框架的使用
|
7月前
egg.js 24.12sequelize模型-where操作符
egg.js 24.12sequelize模型-where操作符
67 1
egg.js 24.12sequelize模型-where操作符
|
7月前
egg.js 24.11sequelize模型-查询多个和获取器
egg.js 24.11sequelize模型-查询多个和获取器
67 0
egg.js 24.11sequelize模型-查询多个和获取器
|
SQL JavaScript 关系型数据库
Sequelize操作MySQL基本用法1
Sequelize操作MySQL基本用法
|
JavaScript
vite无法使用require,require is not defined
vite无法使用require,require is not defined
553 0