Sequelize github 查看更多
Sequelize 中文
什么是ORM署鸡?
簡單的講就是對SQL查詢語句的封裝,讓我們可以用OOP的方式操作數(shù)據(jù)庫磨淌,優(yōu)雅的生成安全阱穗、可維護(hù)的SQL代碼俘种。直觀上,是一種Model和SQL的映射關(guān)系
什么是Sequelize
Sequelize是一款基于Nodejs功能強(qiáng)大的異步ORM框架篇亭。
同時(shí)支持PostgreSQL, MySQL, SQLite and MSSQL多種數(shù)據(jù)庫缠捌,很適合作為Nodejs后端數(shù)據(jù)庫的存儲(chǔ)接口,為快速開發(fā)Nodejs應(yīng)用奠定扎實(shí)译蒂、安全的基礎(chǔ)曼月。
安裝
npm install --save sequelize
npm install --save mysql
npm install --save mysql2
連接數(shù)據(jù)庫
const Sequelize = require('sequelize');
/**
* 配置數(shù)據(jù)庫
* 第一個(gè)參數(shù) boblog 數(shù)據(jù)庫名字
* 第二個(gè)參數(shù) root 數(shù)據(jù)庫名字
* 第三個(gè)參數(shù) password 數(shù)據(jù)庫密碼
*/
const sequelize = new Sequelize('boblog', 'root', '', {
host: 'localhost',
dialect: 'mysql',
operatorsAliases: false,
dialectOptions: {
charset: "utf8mb4",
collate: "utf8mb4_unicode_ci",
supportBigNumbers: true,
bigNumberStrings: true
},
pool: {
max: 5,
min: 0,
acquire: 30000,
idle: 10000
},
timezone: '+08:00' //東八時(shí)區(qū)
});
//驗(yàn)證是否連接成功
sequelize.authenticate().then(() => {
console.log('Success.');
}).catch(err => {
console.error('Failed', err);
});
新建模型 schema
模型定義詳細(xì)文檔(驗(yàn)證器、自定義驗(yàn)證器等)
createdAt
updatedAt
不用傳 sequelize會(huì)自動(dòng)添加
屬性:
type
allowNull
: false, 是否允許值為null
primaryKey
: true, 是否為主鍵
autoIncrement
: true 主鍵是否自增
field
'limits', 指定數(shù)據(jù)表字段名
unique
: true 創(chuàng)建唯一約束
defaultValue
: sequelize.NOW
設(shè)置時(shí)間默認(rèn)值
defaultValue
: 其他默認(rèn)值
comment
: '這是一個(gè)包含注釋的列名'
//schema/role.js
const moment = require('moment');
module.exports = function (sequelize, DataTypes) {
return sequelize.define('role', {
id: {
type: DataTypes.INTEGER.UNSIGNED,
allowNull: false,
primaryKey: true,
autoIncrement: true
},
// 角色名字
name: {
type: DataTypes.STRING(100),
field: 'name',
allowNull: false
},
// 角色權(quán)限
limits: {
type: DataTypes.INTEGER.UNSIGNED,
allowNull: false,
field: 'limits',
default: 0
},
// 這可以創(chuàng)建一個(gè)外鍵:
bar_id: {
type: Sequelize.INTEGER,
references: {
// 這是引用另一個(gè)模型
model: Bar,
// 這是引用模型的列名稱
key: 'id',
// 這聲明什么時(shí)候檢查外鍵約束. 僅限PostgreSQL.
deferrable: Sequelize.Deferrable.INITIALLY_IMMEDIATE
}
createdAt: {
type: DataTypes.DATE,
field: 'created_id',
get() {
return moment(this.getDataValue('createdAt')).format('YYYY-MM-DD');
}
},
updatedAt: {
type: DataTypes.DATE,
field: 'updated_id',
get() {
return moment(this.getDataValue('updatedAt')).format('YYYY-MM-DD HH:mm:ss');
}
}
}, {
// 如果為 true 則表的名稱和 model 相同柔昼,即 user
// 為 false MySQL創(chuàng)建的表名稱會(huì)是復(fù)數(shù) users
// 如果指定的表名稱本就是復(fù)數(shù)形式則不變
timestamps: false, //去除createAt updateAt
freezeTableName: true, 使用自定義表名
})
}
新建model
//model/RoleModel.js
const db = require('../config/db');
const Sequelize = db.sequelize;
const Op = Sequelize.Op;
const Role = Sequelize.import('../schema/role');
Role.sync({force: false});
關(guān)聯(lián)表查詢
const Article = Sequelize.import('../schema/article');
const Category = Sequelize.import('../schema/category');
const User = Sequelize.import('../schema/user');
//設(shè)置表關(guān)聯(lián)
Category.hasMany(Article); // 將會(huì)添加 category_id 到 ArticleModel 模型
User.hasMany(Article); // 將會(huì)添加 authorId 到 ArticleModel 模型
//設(shè)置關(guān)聯(lián)外鍵
Article.belongsTo(Category, {foreignKey: 'categoryId'});
Article.belongsTo(User, {foreignKey: 'authorId'});
//使用
Article.findOne({
where: {
id,
is_del: 0
},
include: [{
model: Category,
where: {categoryId: Sequelize.col('article.categoryId')}
}, {
model: User,
where: {id: Sequelize.col('article.authorId')},
attributes: ['id','nickname']
}],
attributes: {exclude: ['is_del']}
}).then(res=>{})
關(guān)聯(lián) association
不需要外鍵關(guān)聯(lián)
hasMany
一對多
hasOne
一對已一
belongsTo
屬于
return await Test.findOne({
where:{id},
include: [ {
//關(guān)連鍵(test_id)在TestTitles表上
association:Test.hasMany(TestTitles,{foreignKey: 'test_id',as:'titles'}),
include:[ {
association:TestTitles.hasMany(TestOptions,{foreignKey: 't_id',as:'options'})
} ],
},]
});
//關(guān)聯(lián)鍵在UserTest上
await UserTest.findAndCountAll({
where:{userId},
include: [ {
association:UserTest.belongsTo(Test,{foreignKey: 'testId'}),
}]
})
操作符
const Op = Sequelize.Op
[Op.and]: {a: 5} // 且 (a = 5)
[Op.or]: [{a: 5}, {a: 6}] // (a = 5 或 a = 6)
[Op.gt]: 6, // id > 6
[Op.gte]: 6, // id >= 6
[Op.lt]: 10, // id < 10
[Op.lte]: 10, // id <= 10
[Op.ne]: 20, // id != 20
[Op.eq]: 3, // = 3
[Op.not]: true, // 不是 TRUE
[Op.between]: [6, 10], // 在 6 和 10 之間
[Op.notBetween]: [11, 15], // 不在 11 和 15 之間
[Op.in]: [1, 2], // 在 [1, 2] 之中
[Op.notIn]: [1, 2], // 不在 [1, 2] 之中
[Op.like]: '%hat', // 包含 '%hat'
[Op.notLike]: '%hat' // 不包含 '%hat'
[Op.iLike]: '%hat' // 包含 '%hat' (不區(qū)分大小寫) (僅限 PG)
[Op.notILike]: '%hat' // 不包含 '%hat' (僅限 PG)
[Op.regexp]: '^[h|a|t]' // 匹配正則表達(dá)式/~ '^[h|a|t]' (僅限 MySQL/PG)
[Op.notRegexp]: '^[h|a|t]' // 不匹配正則表達(dá)式/!~ '^[h|a|t]' (僅限 MySQL/PG)
[Op.iRegexp]: '^[h|a|t]' // ~* '^[h|a|t]' (僅限 PG)
[Op.notIRegexp]: '^[h|a|t]' // !~* '^[h|a|t]' (僅限 PG)
[Op.like]: { [Op.any]: ['cat', 'hat']} // 包含任何數(shù)組['cat', 'hat'] - 同樣適用于 iLike 和 notLike
[Op.overlap]: [1, 2] // && [1, 2] (PG數(shù)組重疊運(yùn)算符)
[Op.contains]: [1, 2] // @> [1, 2] (PG數(shù)組包含運(yùn)算符)
[Op.contained]: [1, 2] // <@ [1, 2] (PG數(shù)組包含于運(yùn)算符)
[Op.any]: [2,3] // 任何數(shù)組[2, 3]::INTEGER (僅限PG)
[Op.col]: 'user.organization_id' // = 'user'.'organization_id', 使用數(shù)據(jù)庫語言特定的列標(biāo)識(shí)符, 本例使用 PG
支持原生sql語句
const db = require('../config/db');
const Sequelize = db.sequelize;
Sequelize.query('select * from user').then(res=>{
console.log(res)
})
//其他查詢同上
常用DataTypes
更多查看文檔
Sequelize.STRING // VARCHAR(255)
Sequelize.STRING(1234) // VARCHAR(1234)
Sequelize.STRING.BINARY // VARCHAR BINARY
Sequelize.TEXT // TEXT
Sequelize.TEXT('tiny') // TINYTEXT
Sequelize.INTEGER // INTEGER
Sequelize.BIGINT // BIGINT
Sequelize.BIGINT(11) // BIGINT(11)
Sequelize.FLOAT // FLOAT
Sequelize.FLOAT(11) // FLOAT(11)
Sequelize.FLOAT(11, 12) // FLOAT(11,12)
Sequelize.REAL // REAL 僅限于PostgreSQL.
Sequelize.REAL(11) // REAL(11) 僅限于PostgreSQL.
Sequelize.REAL(11, 12) // REAL(11,12) 僅限于PostgreSQL.
Sequelize.DOUBLE // DOUBLE
Sequelize.DOUBLE(11) // DOUBLE(11)
Sequelize.DOUBLE(11, 12) // DOUBLE(11,12)
Sequelize.DECIMAL // DECIMAL
Sequelize.DECIMAL(10, 2) // DECIMAL(10,2)
Sequelize.DATE // DATETIME 針對 mysql / sqlite, TIMESTAMP WITH TIME ZONE 針對 postgres
Sequelize.DATE(6) // DATETIME(6) 針對 mysql 5.6.4+. 小數(shù)秒支持多達(dá)6位精度
Sequelize.DATEONLY // DATE 不帶時(shí)間.
Sequelize.BOOLEAN // TINYINT(1)
Sequelize.ENUM('value 1', 'value 2') // 一個(gè)允許具有 “value 1” 和 “value 2” 的 ENUM
Sequelize.ARRAY(Sequelize.TEXT) // 定義一個(gè)數(shù)組哑芹。 僅限于 PostgreSQL。
Sequelize.ARRAY(Sequelize.ENUM) // 定義一個(gè) ENUM 數(shù)組. 僅限于 PostgreSQL捕透。