导读
https://juejin.im/post/5c99cbdee51d455b251df9eb egg-从入门到上线 (上)
https://juejin.im/post/5cf47b3df265da1bac40007e egg-从入门到上线 (下)
1 安装与配置
1.0 介绍
MongoDB 是由C++语言编写的,是一个基于分布式文件存储的开源数据库系统。<br />在高负载的情况下,添加更多的节点,可以保证服务器性能。<br />MongoDB 旨在为WEB应用提供可扩展的高性能数据存储解决方案。<br />MongoDB 将数据存储为一个文档,数据结构由键值(key=>value)对组成。MongoDB 文档类似于 JSON 对象。字段值可以包含其他文档,数组及文档数组
1.1 mac电脑安装教程
1.1.1 安装homebrew
homebrew的安装查看官网,安装完成后,在终端中输入以下命令更新homebrew的package数据库
brew update
提示:
brew update
升级brew的版本库,brew outdated
查看outdated的库和应用,brew upgrade
升级outdated的库和应用,brew cleanup
清理调过期的库和应用
1.1.2 安装mongodb
使用homebrew安装mongodb,在MAC的终端中输入
cd /
brew install mongodb
若要查看安装信息
brew info mongodb
查看mongodb的版本
mongo --version
which mongod
/usr/local/bin/mongod
如果这样了就安装成功了
启动服务
sudo mongod
1.2 手动部署服务器
1.2.1 下载安装包
wget http://fastdl.mongodb.org/linux/mongodb-linux-i686-1.8.2.tgz
下载完成后解压缩压缩包
tar zxf mongodb-linux-i686-1.8.2.tgz
1.2.2. 安装准备
将mongodb移动到/usr/local/server/mongdb文件夹
mv mongodb-linux-i686-1.8.2 /usr/local/mongodb
创建数据库文件夹与日志文件
mkdir /usr/local/mongodb/data
touch /usr/local/mongodb/logs
1.2.3. 设置开机自启动
将mongodb启动项目追加入rc.local保证mongodb在服务器开机时启动
echo "/usr/local/mongodb/bin/mongod --dbpath=/usr/local/mongodb/data –logpath=/usr/local/mongodb/logs –logappend --auth -–port=27017" >> /etc/rc.local
1.2.4. 启动mongodb
cd到mongodb目录下的bin文件夹启动mongodb
下面这个是需要权限的登录方式, 用户连接需要用户名和密码
/usr/local/mongodb/bin/mongod --dbpath=/usr/local/mongodb/data --logpath=/usr/local/mongodb/logs --logappend --auth --port=27017 --fork
这个是不需要密码的(不建议)
/usr/local/mongodb/bin/mongod --dbpath=/usr/local/mongodb/data --logpath=/usr/local/mongodb/logs --logappend --port=27017 --fork
1.3 宝塔一键完成
1.4 设置密码
1.4.1 进入安装路径的bin目录
cd /www/server/mongodb/bin
1.4.2 输入命令行mongo,进入mongodb环境
mongo
1.4.3 切换到 admin 数据库
use admin
1.4.4 给admin设置用户密码
- user: 用户名
- pwd: 用户密码
- roles: 用来设置用户的权限,比如读,读写 等等
db.createUser({user: 'root', pwd: 'admin_mima', roles: ['root']})
1.4.5 验证是否添加成功,db.auth(用户名,用户密码)
db.auth('root', 'admin_mima')
如果返回 '1’表示验证成功, 如果是 ‘0’ 表示验证失败。<br />
1.4.6 创建一个新的数据库,例如asGiant
use asGiant
1.4.7 接下来为asGiant库添加一个用户,并且赋予权限,
db.createUser({ user: 'aaaa', pwd: 'graphql_mima', roles: [{ role: 'readWrite', db: 'asGiant' }] })
这行代码意思是 创建一个cccc用户 给予读写权限 db表示该用户操作的数据库名。
- Read:允许用户读取指定数据库
- readWrite:允许用户读写指定数据库
- dbAdmin:允许用户在指定数据库中执行管理函数,如索引创建、删除,查看统计或访问system.profile
- userAdmin:允许用户向system.users集合写入,可以找指定数据库里创建、删除和管理用户
- clusterAdmin:只在admin数据库中可用,赋予用户所有分片和复制集相关函数的管理权限。
- readAnyDatabase:只在admin数据库中可用,赋予用户所有数据库的读权限
- readWriteAnyDatabase:只在admin数据库中可用,赋予用户所有数据库的读写权限
- userAdminAnyDatabase:只在admin数据库中可用,赋予用户所有数据库的userAdmin权限
- dbAdminAnyDatabase:只在admin数据库中可用,赋予用户所有数据库的dbAdmin权限。
- root:只在admin数据库中可用。超级账号,超级权限
1.4.8 开启安全登录
一切搞定,重新开机mongodb,通过增加
--auth
开启安全登录
mongod --dbpath /www/server/mongodb/data --auth
如果你是手动安装,那么需要以下操作
mongodb,MongoDB默认是没有开启访问控制,我们通过--auth
参数重启mongod服务。
mongod --dbpath 存放数据库文件夹路径 --auth
mongod --dbpath usr/local/mongodb/bin --auth
一旦开启了,用户连接mongod必须指定用户名和密码。
如果你采用的是宝塔一键完成的
可以通过修改mongodb
的配置文件来实现
修改为
net:
port: 27017
bindIp: 0.0.0.0
#operationProfiling:
#replication:
# replSetName: bt_main
security:
authorization: enabled
javascriptEnabled: false
- bindIp修改为 0.0.0.0 允许外网访问
- authorization 修改为 enabled 开启认证<br />重启一下mongodb
1.5 放行端口
2 工具连接
2.1 下载robo 3t
创建一个连接
点击test
安装完成
2.2 连接加密数据库
xxx.db('mongodb://your name: your pwd@ip:27017/asgiant');
<br />your name
:为用户名<br />your pwd
:为密码
3 数据备份还原
当mongodb 数据库打开了 auth认证 以后 就不能直接使用 dump 而需要提供对应的账号密码 如下
mongodump -h 127.0.0.1:27017 -d asGiant -u 'myz' -p '123456' -o /usr/local/mongodb/dump
-h 地址<br />-d 数据库名称<br />-u 用户名<br />-p 密码<br />-o 输出地址<br />--authenticationDatabase admin 验证账户的数据库
mongorestore命令脚本语法如下:
mongorestore -h <hostname><:port> -d dbname <path>
- --host <:port>, -h <:port>:MongoDB所在服务器地址,默认为: localhost:27017<br />
- --db , -d :需要恢复的数据库实例,例如:test,当然这个名称也可以和备份时候的不一样,比如test2<br />
- --drop:恢复的时候,先删除当前数据,然后恢复备份的数据。就是说,恢复后,备份后添加修改的数据都会被删除,慎用哦!<br />
- <path>:mongorestore 最后的一个参数,设置备份数据所在位置,例如:/usr/local/mongodb/dump。<br />你不能同时指定 <path> 和 --dir 选项,--dir也可以设置备份目录。<br />
- --dir:指定备份的目录<br />你不能同时指定 <path> 和 --dir 选项。
mongorestore -h localhost:27017 -d asGiant -c user --dir /usr/local/mongodb/dump -u myz -p 12346
mongodump -u root -p 123456
mongorestore -u root -p 123456
4 egg-mongoose 配置
4.1 安装
$ npm install egg-mongoose --save
4.2 配置
改变Egg项目中的配置文件{workplace}/config/plugin.js中来启用 egg-mongoose 插件:
exports.mongoose = {
enable: true,
package: 'egg-mongoose',
};
4.3 Egg连接mongoose
在Egg项目中的配置文件{workplace}/config/default.js配置项config添加属性
config.mongoose = {
url: process.env.EGG_MONGODB_URL || 'mongodb://127.0.0.1/website',
options: {
server: {
poolSize: 40,
},
},
};
连接方法
config.mongoose = {
client: {
url: 'mongodb://账号:密码@服务器:端口/库名',
options: {},
},
};
5 设计数据库模型
5.1 定义模型,也就是数据表
在{workplace}/app/model/article.js定义数据表
'use strict';
module.exports = app => {
const mongoose = app.mongoose;
const Schema = mongoose.Schema;
const RoleSchema = new Schema({
role: {
type: String,
index: {
unique: true,
}, // 该字段为唯一字段
require: true, // 必填项
},
roleName: {
type: String,
require: true,
},
// 备注
note: {
type: String,
require: true,
},
});
return mongoose.model('Role', RoleSchema, 'role');
};
5.2 数据类型
数据类型 | |
---|---|
Number | 数字 |
String | 字符串 |
Boolean | 布尔值 |
ObjectId | 对象ID |
Array | 数组 |
Date | 日期 |
Buffer | 二进制 |
Mixed | 混合类型 |
6 增加数据
this.ctx.model.Article.create(post,callback);
备注:其中post为json数据结构,callback为操作后的回调函数
7 查询数据
7.1 获取所有数据,返回是一个数组
this.ctx.model.Article.find()
7.2 获取一个数据,返回是一个对象
this.ctx.model.Article.findOne()
7.3 条件查询
this.ctx.model.Article.find(conditions,callback);
condition有以下几种类型
7.3.1 根据具体数据进行查询
this.ctx.model.Article.find({_id:5c4a819fb87ba4002a47bc4f,title:"123"},callback);
- 返回_id为5c4a819fb87ba4002a47bc4f,title为123的结果
7.3.2 条件查询
"$lt" | 小于 |
---|---|
"$lte" | 小于等于 |
"$gt" | 大于 |
"$gte" | 大于等于 |
"$ne" | 不等于 |
this.ctx.model.Article.find({“sort”:{ $get:18 , $lte:30 });
- 返回Article表中sort 大于等于18并小于等于30的结果
7.3.3 或查询 OR
"$in" | 一个键对应多个值 |
---|---|
"$nin" | 同上取反, 一个键不对应指定值 |
"$or" | 多个条件匹配, 可以嵌套 $in 使用 |
"$not" | 同上取反, 查询与特定模式不匹配的文档 |
this.ctx.model.Article.find({"title":{ $in:[20,21,22."haha"]} );
- 返回Article表中title等于20或21或21或"haha"的结果
this.ctx.model.Article.find({"$or" : [ {"age":18} , {"name":"wxw"} ] });
- 返回Article表中age等于18或 name等于"wxw"的结果
7.3.4 类型查询("$exists"条件判定)
this.ctx.model.Article.find({name: {$exists: true}},function(error,docs){
//返回Article表中所有存在name属性的结果
});
this.ctx.model.Article.find({telephone: {$exists: false}},function(error,docs){
//返回Article表中所有不存在telephone属性的结果
});
7.3.5 匹配正则表达式查询
MongoDb 是使用 Prel兼容的正则表达式库来匹配正则表达式
this.ctx.model.Article.find( {"name" : /joe/i } );
- 返回Article表中name为 joe 的结果, 并忽略大小写
7.3.6 查询数组
this.ctx.model.Article.find({"array":10} );
- 返回Article表中array(数组类型)键中有10的文档, array : [1,2,3,4,5,10] 会匹配到
this.ctx.model.Article.find({"array[5]":10} );
- 返回Article表中array(数组类型)键中下标5对应的值是10, array : [1,2,3,4,5,10] 会匹配到
this.ctx.model.Article.find({"array":[5,10]});
- 返回Article表中查询匹配array数组中既有5又有10的结果
this.ctx.model.Article.find({"array":{$size : 3} });
- 返回Article表中查询匹配array数组长度为3 的的结果
this.ctx.model.Article.find({"array":{$slice : 10} });
- 返回Article表中查询匹配array数组的前10个元素
this.ctx.model.Article.find({"array":{$slice : [5,10]} });
- 返回Article表中查询匹配array数组的第5个到第10个元素
7.3.7 where
用它可以执行任意javacript语句作为查询的一部分,如果回调函数返回 true 文档就作为结果的一部分返回
this.ctx.model.Article.find( {"$where" : "this.x + this.y === 10" } );
this.ctx.model.Article.find( {"$where" : " function(){ return this.x + this.y ===10; } " } )
- 其中this为数据表中的数据,上述返回Article表中属性x+属性y=10的所有数据
8 删除数据
this.ctx.model.Article.remove(conditions,callback);
备注:conditions为查询条件,与查询数据介绍的一样,eg:{ _id:5c4a819fb87ba4002a47bc4f },找到_id为5c4a819fb87ba4002a47bc4f的数据,callback为操作成功后的回调函数
9 更新数据
9.1 更新数据
this.ctx.model.Article.update(conditions, update, callback)
- 参数1:查询条件, 参数2:更新对象,可以使用MondoDB的更新修改器
备注:conditions与查询数据中介绍的一样
9.2 update为更新对象
let post = {
wid: '5c492c57acbe363fd4824446',
column: [ '新闻' ],
titleHead: '',
img: '',
isAbstract: 'false',
}
this.ctx.model.Article.update({ _id: '5c4a819fb87ba4002a47bc4f ' }, post)
- 查询Article表中特定_id,并对post中所包含的属性进行更新。
update使用MondoDB的更新修改器,有以下几种使用场景
9.2.1 "$inc"增减修改器,只对数字有效
this.ctx.model.Article.update({"age":22}, {$inc:{"age":1} } );
- 找到age=22的文档,修改文档的age值自增1
9.2.2 '$set' 指定一个键的值,这个键不存在就创建它.可以是任何MondoDB支持的类型.
this.ctx.model.Article.update({ _id:5c4a819fb87ba4002a47bc4f }, { $set: { isDelete: true } });
- 对5c4a819fb87ba4002a47bc4f 表进行软删除,找到特定_id数据,增加或者修改isDelete属性
9.2.3 "$unset"同上取反,删除一个键
this.ctx.model.Article.update({age:22}, {$unset:{age:18} } );
- 执行后age键不存在
9.2.4 '$push'给一个键push一个数组成员,键不存在会创建,对数组有效
this.ctx.model.Article.update({name:'wxw'}, {$push:{array:10} } );
- 返回Article表中name为wxw的数据,增加一个array键,类型为数组,有一个成员 10
9.2.5 '$addToSet'向数组中添加一个元素,如果存在就不添加
this.ctx.model.Article.update({name:'wxw'},{$addToSet:{array:10} } );
- 返回Article表中name为wxw的数据,array中有10所以不会添加
9.2.6 'push 修改器配合可以插入多个值
this.ctx.model.Article.update({name:'wxw'}, {$push:{array:{$each: [1,2,3,4,5]}} } );
- 返回Article表中name为wxw的数据,执行后array : [10,1,2,3,4,5]
9.2.7 '$pop' 向数组中尾部删除一个元素
this.ctx.model.Article.update({name:'wxw'}, {$pop:{array:1} } );
- 返回Article表中name为wxw的数据,其中array : [10,1,2,3,4,5],执行后 array : [10,1,2,3,4]
- tip:将1改成-1可以删除数组首部元素
9.2.8 '$pull' 向数组中删除指定元素
this.ctx.model.Article.update({name:'wxw'}, {$pull:{array:10} });
- 返回Article表中name为wxw的数据,匹配到array中的10后将其删除。
10 排序(sort)
this.ctx.model.Article.sort({ isSetTop: -1, sort: 1, editTime: -1 });
- 对Article表中的数据进行排序,先按“isSetTop”降序,再按“sort”升序,最后按“editTime”降序
备注:键对应数据中的键名,值代表排序方向,1 升序, -1降序。
11 限制返回结果的数量(limit)
this.ctx.model.Article.limit(3);
- 对Article表中的数据进行返回,返回为前面3条数据
12 跳过前3个文档,返回其余的(skip)
this.ctx.model.Article.skip(3);
- 对Article表中的数据进行返回,跳过前面3条数据,返回其余数据
附:综合使用最后三个方法进行分页查询
this.ctx.model.Article.find({ _id:5c4a819fb87ba4002a47bc4f }).skip(pageSize * (pageNum - 1)).limit(parseInt(pageSize)).sort({ isSetTop: -1, sort: 1, editTime: -1 });
- 其中pageSize和pageNum为动态传递数据,返回Article表中特定_id在每页数据为pageSize条件下的第pageNum页中的数据,并按照“isSetTop”降序,再按“sort”升序,最后按“editTime”降序进行排序。