导读
https://juejin.im/post/5c99cbdee51d455b251df9eb egg-从入门到上线 (上)
https://juejin.im/post/5cf47b3df265da1bac40007e egg-从入门到上线 (下)
1 安装与配置
1.0 介绍
MongoDB 是由C++语言编写的，是一个基于分布式文件存储的开源数据库系统。
在高负载的情况下，添加更多的节点，可以保证服务器性能。
MongoDB 旨在为WEB应用提供可扩展的高性能数据存储解决方案。
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 宝塔一键完成
image.png
1.4 设置密码
1.4.1 进入安装路径的bin目录
cd /www/server/mongodb/bin
1.4.2 输入命令行mongo，进入mongodb环境
mongo
image.png
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’ 表示验证失败。
image
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必须指定用户名和密码。
image.png
如果你采用的是宝塔一键完成的
可以通过修改mongodb的配置文件来实现
image.png
修改为
image.png
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 开启认证
重启一下mongodb
1.5 放行端口
image.png
2 工具连接
2.1 下载robo 3t
image.png
image.png
创建一个连接
image.png
image.png
点击test
image.png
安装完成
image.png
2.2 连接加密数据库
xxx.db('mongodb://your name: your pwd@ip:27017/asgiant');your name：为用户名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 地址
-d 数据库名称
-u 用户名
-p 密码
-o 输出地址
--authenticationDatabase admin 验证账户的数据库
mongorestore命令脚本语法如下：
mongorestore -h <:port> -d dbname
- --host <:port>, -h <:port>：MongoDB所在服务器地址，默认为： localhost:27017
- --db , -d ：需要恢复的数据库实例，例如：test，当然这个名称也可以和备份时候的不一样，比如test2
- --drop：恢复的时候，先删除当前数据，然后恢复备份的数据。就是说，恢复后，备份后添加修改的数据都会被删除，慎用哦！
-
： mongorestore 最后的一个参数，设置备份数据所在位置，例如：/usr/local/mongodb/dump。
你不能同时指定和 --dir 选项，--dir也可以设置备份目录。 - --dir：指定备份的目录
你不能同时指定和 --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”降序进行排序。