目录
什么是mongodb
主要特点
MongoDB 概念解析
完整术语列表
MongoDB 安装
MongoDB Shell
安装 MongoDB Shell
验证 MongoDB Shell
数据库管理
查看数据库列表
创建数据库
实例
删除数据库
实例
默认数据库
系统内置数据库
集合管理
查看集合
创建集合
实例
更新集合名
renameCollection 命令的语法:
参数说明:
实例
删除聚合
语法格式:
实例
文档操作
常用的插入文档方法包括:
insertOne()
参数说明:
实例
insertMany()
参数说明:
实例
查询文档
find () 方法
参数说明:
查找所有文档:
说明:
说明:
findOne () 方法
除文档删
deleteOne()
deleteMany()
语法:
实例
findOneAndDelete()
语法:
实例
更新文档
updateOne()
语法:
实例
updateMany()
语法:
实例
replaceOne()
语法:
实例
MongoDB 备份 (mongodump) 与恢复 (mongorestore)
安装备份与恢复命令
MongoDB 数据备份
MongoDB 数据恢复
MongoDB 用户管理
连接到 MongoDB
切换到目标数据库
创建用户
验证用户
启用身份验证
使用用户身份登录
删除用户
实例操作
什么是mongodb
MongoDB 是一个文档型数据库,数据以类似 JSON 的文档形式存储。
MongoDB 的设计理念是为了应对大数据量、高性能和灵活性需求。
MongoDB 使用集合(Collections)来组织文档(Documents),每个文档都是由键值对组成的。
- 数据库(Database):存储数据的容器,类似于关系型数据库中的数据库。
- 集合(Collection):数据库中的一个集合,类似于关系型数据库中的表。
- 文档(Document):集合中的一个数据记录,类似于关系型数据库中的行(row),以 BSON 格式存储。
MongoDB 将数据存储为一个文档,数据结构由键值 (key=>value) 对组成,文档类似于 JSON 对象,字段值可以包含其他文档,数组及文档数组:
主要特点
- 文档导向的存储:MongoDB 是一个面向文档的数据库,它以 JSON-like 的格式存储数据,使得数据结构更加灵活和丰富。
- 索引优化查询:MongoDB 允许用户为文档中的任意属性创建索引,例如 FirstName 和 Address,从而提高查询效率和排序性能。
- 数据镜像与扩展性:通过本地或网络创建数据的副本,MongoDB 实现了强大的数据冗余和扩展能力。
- 水平扩展与分片:面对增加的负载,MongoDB 可以通过分片技术将数据分布到计算机网络中的其他节点上,实现水平扩展。
- 强大的查询语言:MongoDB 使用 JSON 格式的查询语法,支持复杂的查询表达式,包括对内嵌对象和数组的查询。
- 数据更新:利用 update () 命令,MongoDB 能够替换整个文档或更新指定的数据字段,
- MapReduce 批量处理:MongoDB 的 MapReduce 功能专为大规模数据处理和聚合操作设计,通过 Map 函数的 emit (key, value) 调用和 Reduce 函数的逻辑处理,实现高效的数据汇总。
- MapReduce 脚本编写:Map 和 Reduce 函数使用 JavaScript 编写,可以通过 db.runCommand 或 mapreduce 命令在 MongoDB 中执行。
- GridFS 大文件存储:GridFS 是 MongoDB 内置的功能,用于存储和检索大于 BSON 文档大小限制的文件,如图片和视频。
- 服务端脚本执行:MongoDB 允许在服务端执行 JavaScript 脚本,提供了直接在服务端执行或存储函数定义以供后续调用的能力。
- 多语言支持:MongoDB 提供了对多种编程语言的支持,包括但不限于 RUBY、PYTHON、JAVA、C++、PHP 和 C#。
MongoDB 概念解析
SQL 术语 / 概念 | MongoDB 术语 / 概念 | 解释 / 说明 |
---|---|---|
database | database | 数据库 |
table | collection | 数据库表 / 集合 |
row | document | 数据记录行 / 文档 |
column | field | 数据字段 / 域 |
index | index | 索引 |
table joins | 表连接,MongoDB 不支持 | |
primary key | primary key | 主键,MongoDB 自动将_id 字段设置为主键 |
完整术语列表
文档(Document):MongoDB 的基本数据单元,通常是一个 JSON-like 的结构,可以包含多种数据类型。
集合(Collection):类似于关系型数据库中的表,集合是一组文档的容器。在 MongoDB 中,一个集合中的文档不需要有一个固定的模式。
数据库(Database):包含一个或多个集合的 MongoDB 实例。
BSON:Binary JSON 的缩写,是 MongoDB 用来存储和传输文档的二进制形式的 JSON。
索引(Index):用于优化查询性能的数据结构,可以基于集合中的一个或多个字段创建索引。
分片(Sharding):一种分布数据到多个服务器(称为分片)的方法,用于处理大数据集和高吞吐量应用。
副本集(Replica Set):一组维护相同数据集的 MongoDB 服务器,提供数据的冗余备份和高可用性。
主节点(Primary):副本集中负责处理所有写入操作的服务器。
从节点(Secondary):副本集中的服务器,用于读取数据和在主节点故障时接管为主节点。
MongoDB Shell:MongoDB 提供的命令行界面,用于与 MongoDB 实例交互。
聚合框架(Aggregation Framework):用于执行复杂的数据处理和聚合操作的一系列操作。
Map-Reduce:一种编程模型,用于处理大量数据集的并行计算。
GridFS:用于存储和检索大于 BSON 文档大小限制的文件的规范。
ObjectId:MongoDB 为每个文档自动生成的唯一标识符。
CRUD 操作:创建(Create)、读取(Read)、更新(Update)、删除(Delete)操作。
事务(Transactions):从 MongoDB 4.0 开始支持,允许一组操作作为一个原子单元执行。
操作符(Operators):用于查询和更新文档的特殊字段。
连接(Join):MongoDB 允许在查询中使用 $lookup 操作符来实现类似 SQL 的连接操作。
TTL(Time - To - Live):可以为集合中的某些字段设置 TTL,以自动删除旧数据。
存储引擎(Storage Engine):MongoDB 用于数据存储和管理的底层技术,如 WiredTiger 和 MongoDB 的旧存储引擎 MMAPv1。
MongoDB Compass:MongoDB 的图形界面工具,用于可视化和管理 MongoDB 数据。
MongoDB Atlas:MongoDB 提供的云服务,允许在云中托管 MongoDB 数据库。
MongoDB 安装
MongoDB 的安装过程简单直观,便于用户快速部署和使用。MongoDB 提供了 linux 各个发行版本 64 位的安装包,你可以在官网下载安装包。
安装前我们需要安装各个 Linux 平台依赖包
dnf install libcurl openssl -y
解压安装包
ar -zxvf mongodb-linux-x86_64-rhel8-8.0.8.tgz
将解压包拷贝到指定目录
mv mongodb-linux-x86_64-rhel88-8.0.8 /usr/local/mongodb
MongoDB 的可执行文件位于 bin 目录下,所以可以将其添加到 PATH 路径中:
echo 'export PATH=/usr/local/mongodb/bin:$PATH' >>/etc/profile
source /etc/profile
创建数据库目录
默认情况下 MongoDB 启动后会初始化以下两个目录:
- 数据存储目录:/var/lib/mongodb
- 日志文件目录:/var/log/mongodb
我们在启动前可以先创建这两个目录并设置当前用户有读写权限:
[root@localhost ~]#mkdir -p /var/lib/mongo
[root@localhost ~]#mkdir -p /var/log/mongodb
[root@localhost ~]#chown `whoami` /var/lib/mongo # 设置权限
[root@localhost ~]#chown `whoami` /var/log/mongodb # 设置权限
由于 mongodb 依赖 openssl11,需要编译安装 openssl11
[root@localhost ~]# dnf install -y gcc make perl
[root@localhost ~]# tar xzf openssl-1.1.1w.tar.gz
[root@localhost ~]# cd openssl-1.1.1w
[root@sentinel01 openssl-1.1.1w]#./config --prefix=/opt/openssl11 --openssldir=/opt/openssl11/ssl
[root@sentinel01 openssl-1.1.1w]#make -j$(nproc)
[root@sentinel01 openssl-1.1.1w]#make install
接下来启动 Mongodb 服务:
[root@localhost ~]# mongod --dbpath /var/lib/mongo --logpath /var/log/mongodb/mongod.log --fork
看到以下信息,说明启动成功。
MongoDB Shell
MongoDB Shell 是 MongoDB 提供的官方交互式界面,允许用户与 MongoDB 数据库进行交互、执行命令和操作数据库。
MongoDB Shell 是基于 JavaScript 的,允许用户直接在命令行或者脚本中使用 JavaScript 语言来操作 MongoDB 数据库。
安装 MongoDB Shell
解压安装包,将 bin 目录中 mongosh 二进制文件复制到 PATH 变量中列出的目录中,例如 /usr/local/bin:
[root@localhost ~]# tar xzf mongosh-2.5.0-linux-x64-openssl3.tgz
[root@localhost ~]# cd mongosh-2.5.0-linux-x64-openssl3
[root@localhost mongosh-2.5.0-linux-x64-openssl3]# cd bin/
[root@localhost bin]# cp mongosh /usr/local/bin/
[root@localhost bin]# cp mongosh_crypt_v1.so /usr/local/lib/
验证 MongoDB Shell
打开你的终端并使用 mongosh 命令连接到 MongoDB 服务器:
mongosh --host <hostname> --port <port>
说明:
- mongosh:启动 MongoDB Shell 命令行工具。
- --host <hostname>:指定 MongoDB 服务器的主机名或 IP 地址。
- <hostname>:MongoDB 服务器的主机名(如 localhost)或 IP 地址(如 127.0.0.1)。
- --port <port>:指定 MongoDB 服务器的端口号。
- <port>:MongoDB 服务器监听的端口号,默认端口是 27017。
输入 mongosh 默认连接本地 mongodb 数据库,看到以下信息说明登录成功,warnings 警告为优化提醒,可以暂时忽略,如若生产环境部署需要处理
plaintext
[root@sentinel01 bin]# mongosh
Current Mongosh Log ID: 680a1533277aa1c07b1b26ff
Connecting to: mongodb://127.0.0.1:27017/?directConnection=true&serverSelectionTimeoutMS=2000&appName=mongosh+2.5.0
Using MongoDB: 8.0.8
Using Mongosh: 2.5.0For mongosh info see: https://www.mongodb.com/docs/mongodb-shell/The server generated these startup warnings when booting
2025-04-24T18:22:55.898280+08:00: Using the XFS filesystem is strongly recommended with the WiredTiger storage engine. See http://dochub.mongodb.org/core/prod-notes-filesystem
2025-04-24T18:22:55.898280+08:00: Access control is not enabled for the database. Read and write access to data and configuration is unrestricted
2025-04-24T18:22:55.898280+08:00: You are running this process as the root user, which is not recommended2025-04-24T18:22:55.898280+08:00: This server is bound to localhost. Remote systems will be unable to connect to this server. Start the server with --bind_ip <address> to specify which IP addresses it should serve responses from, or with --bind_ip_all to bind to all interfaces. If this behavior is desired, start the server with --bind_ip 127.0.0.1 to disable this warning
2025-04-24T18:22:55.898280+08:00: Soft rlimits too low
2025-04-24T18:22:55.898280+08:00: For customers running the database memory allocator we suggest changing the contents of the following sysctl file
2025-04-24T18:22:55.898280+08:00: We suggest setting the contents of /proc/sys/vm/zone_reclaim_mode to 0 or 1, as a
wapping can cause performance problems.test>
数据库管理
查看数据库列表
要查看当前 MongoDB 实例中所有数据库的列表,可以使用 show dbs
命令:
> show dbs
要查看当前正在使用的数据库,可以使用 db
命令:
> db
创建数据库
在 MongoDB 中,数据库的创建是一个简单的过程,当你首次向 MongoDB 中插入数据时,如果数据库不存在,MongoDB 会自动创建它。
我们只需选择一个数据库名称,并开始向其中插入文档即可。
当你使用 use
命令来指定一个数据库时,如果该数据库不存在,MongoDB 将自动创建它。
MongoDB 创建数据库的语法格式如下:
use DATABASE_NAME
如果数据库不存在,则创建数据库,否则切换到指定数据库。
实例
以下实例我们创建了数据库 runoob:
test> use runoob
switched to db runoob
runoob> db
runoob
runoob>
执行 use runoob 命令后,MongoDB 将创建名为 runoob 的新数据库。此时,你可以开始在这个数据库中创建集合和插入文档。
如果你想查看所有数据库,可以使用 show dbs 命令:
runoob> show dbs
admin 40.00 KiB
config 60.00 KiB
local 40.00 KiB
runoob>
可以看到,我们刚创建的数据库 runoob 并不在数据库的列表中,要显示它,我们需要向 runoob 数据库插入一些数据。
runoob> db.runoob.insertOne({"name":"zhangsan"})
{acknowledged: true,insertedId: ObjectId('680a18f4277aa1c07b1b2700')
}
runoob> show dbs
admin 40.00 KiB
config 60.00 KiB
local 40.00 KiB
runoob 40.00 KiB
runoob>
删除数据库
如果你需要删除数据库,可以使用 db.dropDatabase()
方法:
use myDatabase
db.dropDatabase()
上述命令将删除当前正在使用的 myDatabase 数据库及其所有集合。
实例
runoob> show dbs
admin 40.00 KiB
config 60.00 KiB
local 40.00 KiB
runoob 40.00 KiB
runoob> use runoob
already on db runoob
test> db.dropDatabase()
{ ok: 1, dropped: 'runoob' }
runoob> show dbs
admin 40.00 KiB
config 60.00 KiB
local 40.00 KiB
默认数据库
MongoDB 中默认的数据库为 test,如果没有创建新的数据库,数据将存放在 test 数据库中。
当通过 shell 连接到 MongoDB 实例时,如果未使用 use 命令切换到其他数据库,则会默认使用 test 数据库。
例如,在启动 MongoDB 实例并连接到 MongoDB shell 后,如果开始插入文档而未显式指定数据库,MongoDB 将默认使用 test 数据库。
系统内置数据库
在 MongoDB 中,admin、config 和 local 是三个特殊的系统内置数据库
- admin 数据库:存储所有数据库的用户身份信息和全局权限(如 root 用户)。用户必须通过 admin 数据库认证后才能执行跨库管理操作。
- config 数据库:仅在分片集群环境中存在。存储分片信息、块(chunk)分布、集合分片策略等关键元数据。
- local 数据库:存储当前节点的副本集状态、操作日志(oplog)等本地数据。数据不会被复制到其他节点,仅存在于当前实例。
集合管理
查看集合
查看当前库已有集合,可以使用 show collections
或 show tables
命令
> show collections
创建集合
MongoDB 中使用 createCollection()
方法来创建集合。
语法格式:
db.createCollection(name, options)
参数说明:
name
:要创建的集合名称。options
:可选参数,指定有关内存大小及索引的选项。
options
可以是如下参数:
参数名 | 类型 | 描述 | 示例值 |
---|---|---|---|
capped | 布尔值 | 是否创建一个固定大小的集合。 | true |
size | 数值 | 集合的最大大小(以字节为单位)。仅在 capped 为 true 时有效。 | 10485760(10MB) |
max | 数值 | 集合中允许的最大文档数。仅在 capped 为 true 时有效。 | 5000 |
validator | 对象 | 用于文档验证的表达式。 | { $jsonSchema: { ... } } |
validationLevel | 字符串 | 指定文档验证的严格程度。"off" :不进行验证。"strict" :插入和更新操作都必须通过验证(默认)。"moderate" :仅现有文档更新时必须通过验证,插入新文档时不需要。 | "strict" |
validationAction | 字符串 | 指定文档验证失败时的操作。"error" :阻止插入或更新(默认)。"warn" :允许插入或更新,但会发出警告。 | "error" |
storageEngine | 对象 | 为集合指定存储引擎配置。 | { wiredTiger: { ... } } |
collation | 对象 | 指定集合的默认排序规则。 | { locale: "en", strength: 2 } |
在插入文档时,MongoDB 首先检查固定集合的 size
字段,然后检查 max
字段。
使用这些选项创建一个集合的实例:
db.createCollection("myComplexCollection", {capped: true,size: 10485760,max: 5000,validator: { $jsonSchema: {bsonType: "object",required: ["name", "email"],properties: {name: {bsonType: "string",description: "必须为字符串且为必填项"},email: {bsonType: "string",pattern: ".*@.*\\..*$",description: "必须为有效的电子邮件地址"}}}},validationLevel: "strict",validationAction: "error",storageEngine: {wiredTiger: { configString: "block_compressor=zstd" }},collation: { locale: "en", strength: 2 }
});
这个例子创建了一个集合,具有以下特性:
固定大小,最大 10MB,最多存储 5000 个文档。
文档必须包含 name 和 email 字段,其中 name 必须是字符串,email 必须是有效的电子邮件格式。
验证级别为严格,验证失败将阻止插入或更新。
使用 WiredTiger 存储引擎,指定块压缩器为 zstd。
默认使用英语排序规则。
实例
在 test 数据库中创建 runoob 集合:
> use test
switched to db test
> db.createCollection("runoob")
{ "ok" : 1 }
注意: 在 MongoDB 中,集合只有在内容插入后才会创建,就是说,创建集合(数据表)后要再插入一个文档(记录),集合才会真正创建。
更新集合名
在 MongoDB 中,不能直接通过命令来重命名集合。
MongoDB 可以使用 renameCollection
方法来重命名集合。
renameCollection
命令的语法:
db.adminCommand({renameCollection: "sourceDb.sourceCollection",to: "targetDb.targetCollection",dropTarget: <boolean>
})
参数说明:
renameCollection
:要重命名的集合的完全限定名称(包括数据库名)。to
:目标集合的完全限定名称(包括数据库名)。dropTarget
(可选):布尔值。如果目标集合已经存在,是否删除目标集合。默认值为false
。
实例
假设你要将 test 数据库中的 oldCollection 重命名为 newCollection,可以按以下步骤进行:
确保已连接到 test 数据库
use test
运行 renameCollection 命令
db.adminCommand({renameCollection: "test.oldCollection",to: "test.newCollection" });
如果你要将集合重命名到另一个数据库,例如将 test 数据库中的 oldCollection 重命名为 production 数据库中的 newCollection,可以这样做:
db.adminCommand({renameCollection: "test.oldCollection",to: "production.newCollection" });
删除聚合
MongoDB 中使用 drop()
方法来删除集合。
drop()
方法可以永久地从数据库中删除指定的集合及其所有文档,这是一个不可逆的操作,因此需要谨慎使用。
语法格式:
db.collection名称.drop()
如果成功删除选定集合,则 drop()
方法返回 true
,否则返回 false
。
实例
在数据库 mydb
中,我们可以先通过 show collections
命令查看已存在的集合:
>use mydb
switched to db
>db.createCollection("kgc")
{ ok: 1 }
mydb>show collections
kgc
接着删除集合 kgc
:
>db.kgc.drop()
true
通过 show collections
再次查看数据库 mydb
中的集合:
>show collections
从结果中可以看出 kgc
集合已被删除。
文档操作
文档的数据结构和 JSON 基本一样。所有存储在集合中的数据都是 BSON 格式。BSON 是一种类似 JSON 的二进制形式的存储格式,是 Binary JSON 的简称。
常用的插入文档方法包括:
方法 | 用途 | 是否弃用 |
---|---|---|
insertOne() | 插入单个文档 | 否 |
insertMany() | 插入多个文档 | 否 |
insert() | 插入单个或多个文档 | 是 |
save() | 插入或更新文档 | 是 |
在 MongoDB 中,插入文档时如果集合(Collection)不存在,数据库会自动创建该集合。这是 MongoDB 的默认行为,也是其无模式设计(Schema-less)的核心特性之一
insertOne()
insertOne()
方法用于在集合中插入单个文档。
db.collection名称.insertOne(document, options)
参数说明:
document
:要插入的单个文档。options
(可选):一个可选参数对象,可以包含writeConcern
和bypassDocumentValidation
等。
实例
db.myCollection.insertOne({name: "Alice",age: 25,city: "New York"
});
返回结果
{"acknowledged": true,"insertedId": ObjectId("60c72b2f9b1d8b5af8e2b2d")
}
insertMany()
insertMany()
方法用于在集合中插入多个文档。
db.collection.insertMany(documents, options)
参数说明:
documents
:要插入的文档数组。options
(可选):一个可选参数对象,可以包含ordered
、writeConcern
和bypassDocumentValidation
等。
实例
插入多个文档的示例(示例未完整展示 )。
db.myCollection.insertMany([{ name: "Bob", age: 30, city: "Los Angeles" },// 可继续添加更多文档...
]);
返回结果:
{"acknowledged": true,"insertedIds": [ObjectId("60c72b2f9b1d8b5af8e2b2e"),ObjectId("60c72b2f9b1d8b5af8e2b2f")]
}
查询文档
MongoDB 查询文档使用 find()
、findOne()
方法。
find () 方法
find()
方法以非结构化的方式来显示所有文档。
MongoDB 查询数据的语法格式如下:
db.collection.find(query, projection)
参数说明:
query
:用于查找文档的查询条件。默认为{}
,即匹配所有文档。projection
(可选):指定返回结果中包含或排除的字段。
查找所有文档:
实例
db.myCollection.find();
按条件查找文档:
db.myCollection.find({ age: { $gt: 25 } });
说明:
$gt
是 MongoDB 的比较操作符,表示 “大于”(Greater Than)。
这个条件的作用是筛选出 age 字段值大于 25 的文档。
类似的其他比较操作符
$gt
(大于)、$lt
(小于)、$gte
(大于等于)、$lte
(小于等于)$eq
(等于)、$ne
(不等于)
按条件查找文档,并只返回指定字段:
实例
db.myCollection.find({ age: { $gt: 25 } },{ name: 1, age: 1, _id: 0 }
);
说明:
{ name: 1, age: 1, _id: 0 }
- 投影(Projection)
用于控制返回的字段(类似 SQL 中的 SELECT 语句):1
表示包含该字段,0
表示排除该字段。例如 _id: 0
表示排除默认返回的 _id
字段。所以最终返回的文档仅包含 name
和 age
字段。
如果你需要以易读的方式来读取数据,可以使用 pretty()
方法,语法格式如下:
>db.myCollection.find().pretty()
pretty()
方法以格式化的方式来显示所有文档。
findOne () 方法
findOne()
方法用于查找集合中的单个文档。如果找到多个匹配的文档,它只返回第一个。
语法
db.collection.findOne(query, projection)
query
:用于查找文档的查询条件。默认为{}
,即匹配所有文档。projection
(可选):指定返回结果中包含或排除的字段。
查询单个文档:
db.myCollection.findOne({ name: "Alice" });
查询单个文档,并只返回指定字段:
db.myCollection.findOne({ name: "Alice" },{ name: 1, age: 1, _id: 0 }
);
除文档删
常用的删除文档方法包括 deleteOne()
、deleteMany()
以及 findOneAndDelete()
。
deleteOne()
deleteOne()
方法用于删除匹配过滤器的单个文档。
语法:
db.myCollection.findOne({ name: "Alice" });
参数说明:
filter
:用于查找要删除的文档的查询条件。options
(可选):一个可选参数对象。
实例
db.collection.deleteOne(filter, options)
返回结果:
{"acknowledged": true,"deletedCount": 1
}
deleteMany()
deleteMany()
方法用于删除所有匹配过滤器的文档。
语法:
db.collection.deleteMany(filter, options)
filter
:用于查找要删除的文档的查询条件。options
(可选):一个可选参数对象。
实例
db.myCollection.deleteMany({ name: "Bob" });
返回结果
{"acknowledged": true,"deletedCount": 1
}
findOneAndDelete()
findOneAndDelete()
方法用于查找并删除单个文档,并可以选择返回删除的文档。
语法:
db.collection.findOneAndDelete(filter, options)
filter
:用于查找要删除的文档的查询条件。options
:可选参数对象,如projection
、sort
等。
实例
db.myCollection.findOneAndDelete({ name: "Charlie" },{ projection: { name: 1, age: 1 } }
);
findOneAndDelete
返回被删除的文档,如果找不到匹配的文档,则返回 null
。
更新文档
在 MongoDB 中,更新文档的操作可以使用多种方法实现,常用的方法包括 updateOne()
、updateMany()
、replaceOne()
和 findOneAndUpdate()
。
插入测试数据
db.myCollection.insertMany([{ name: "Alice", age: 25, city: "Los Angeles", status: "inactive" },{ name: "Bob", age: 30, city: "Los Angeles", status: "active" },{ name: "Charlie", age: 35, city: "Chicago", status: "active" }
]);
预先插入用于演示更新操作的测试文档数据。
updateOne()
updateOne()
方法用于更新匹配过滤器的单个文档。
语法:
db.collection.updateOne(filter, update, options)
参数说明:
filter
:用于查找文档的查询条件。update
:指定更新操作的文档或更新操作符。options
:可选参数对象,如upsert
、arrayFilters
等。
实例
db.myCollection.updateOne({ name: "Alice", // 过滤条件age: { $ne: 26 } // 过滤条件}, { $set: { age: 26 } }, // 更新操作{ upsert: false } // 可选参数
);
upsert
选项:
false
(默认值):若没有匹配文档,不执行任何操作。true
:若未找到匹配文档,将插入一个新文档(合并查询条件和更新操作的内容)。
例如本案例,不匹配时会插入新文档{ name: "Alice", age: 26 }
。
更新单个文档:
db.myCollection.updateOne({ name: "Alice" },{ $set: { age: 28 } }
);
updateMany()
updateMany()
方法用于更新所有匹配过滤器的文档。
语法:
db.collection.updateMany(filter, update, options)
参数说明:
filter
:用于查找文档的查询条件。update
:指定更新操作的文档或更新操作符。options
:可选参数对象,如upsert
、arrayFilters
等。
实例
db.myCollection.updateMany({ age: { $lt: 30 } }, // 过滤条件{ $set: { status: "active" } },// 更新操作{ upsert: false } // 可选参数
);
更新多个文档:
db.myCollection.updateMany({ age: { $lt: 30 } },{ $set: { status: "active" } }
);
replaceOne()
replaceOne()
方法用于替换匹配过滤器的单个文档,新的文档将完全替换旧的文档。
语法:
db.collection.replaceOne(filter, replacement, options)
参数说明:
filter
:用于查找文档的查询条件。replacement
:新的文档,将替换旧的文档。options
:可选参数对象,如upsert
等。
实例
db.myCollection.findOneAndUpdate({ name: "Charlie" }, // 过滤条件{ $set: { age: 30 } }, // 更新操作{ returnDocument: "after" } // 可选参数,返回更新后的文档
);
查找并更新单个文档
db.myCollection.findOneAndUpdate({ name: "Charlie" },{ $set: { age: 30 } },{ returnDocument: "after" }
);
MongoDB 备份 (mongodump) 与恢复 (mongorestore)
安装备份与恢复命令
[root@localhost ~]# rpm -ivh mongodb-database-tools-rhel8-x86_64-100.6.0.rpm
MongoDB 数据备份
在 MongoDB 中使用 mongodump
命令来备份数据,该命令可导出所有数据到指定目录中。
mongodump
命令可通过参数指定导出的数据所属的服务器。
mongodump
命令的基本语法:
mongodump -h dbhost -d database -o dbdirectory
-h
:指定 MongoDB 所在服务器地址,例如:127.0.0.1,当然也可以指定端口号:127.0.0.1:27017-d
:指定要备份的数据库实例,例如:test-o
:指定备份数据的存放位置,例如:/data/dump,当然该目录需要提前建立,当备份完成后,系统自动在dump目录下建立一个test目录,这个目录里存放该数据库实例的备份数据。
[root@localhost ~]# mongodump
执行 mongodump
命令后,客户端会连接到 ip
为 127.0.0.1
、端口号为 27017
的 MongoDB 服务上,并备份所有数据到命令执行所在目录下的 dump/
目录中
[root@localhost ~]# mongodump
2025-04-25T22:44:21.307+0800 writing admin.system.version to dump/admin/system.version.bson
2025-04-25T22:44:21.307+0800 done dumping admin.system.version (1 document)
2025-04-25T22:44:21.308+0800 writing mydb.myCollection to dump/mydb/myCollection.bson
2025-04-25T22:44:21.308+0800 writing test.myComplexCollection to dump/test/myComplexCollection.bson
2025-04-25T22:44:21.310+0800 writing test.myCollection to dump/test/myCollection.bson
2025-04-25T22:44:21.313+0800 done dumping test.myCollection (3 documents)
2025-04-25T22:44:21.313+0800 done dumping test.myComplexCollection (0 documents)
2025-04-25T22:44:21.334+0800 done dumping mydb.myCollection (3 documents)
[root@localhost ~]# ls
dump
mongodump 命令可选参数列表
语法 | 描述 | 实例(部分显示) |
---|---|---|
mongodump --host HOST_NAME --port PORT_NUMBER | 备份所有 MongoDB 数据 | mongodump --host runoob.com --port 27017 |
mongodump --dbpath DB_PATH --out BACKUP_DIRECTORY | (描述未完整显示 ) | mongodump --dbpa... |
mongodump --collection COLLECTION --db DB_NAME | 备份指定数据库的集合 | mongodump --collection mycol -d test |
MongoDB 数据恢复
MongoDB 使用 mongorestore
命令恢复备份数据,
mongorestore
命令脚本语法如下:
mongorestore -h <hostname><:port> -d dbname <path>
--host <:port>
/-h <:port>
:MongoDB 所在服务器地址,默认localhost:27017
。--db
/-d
:需恢复的数据库实例,如test
,可与备份时名称不同(举例test2
)。--drop
:恢复前先删除目标数据库数据,备份后添加 / 修改的数据会被删除,慎用。<path>
:mongorestore
最后一个参数,设置备份数据所在位置(举例c:\data\dump\test
),不能与--dir
同时用。--dir
:指定备份目录,不能与<path>
同时用。
执行以下命令:
[root@localhost ~]# mongorestore
mongorestore
默认从当前执行命令路径下的 dump
目录中读取备份数据。
执行以上命令输出结果如下:
[root@localhost ~]# mongorestore
2025-04-25T22:50:28.111+0800 using default 'dump' directory
2025-04-25T22:50:28.111+0800 preparing collections to restore from
2025-04-25T22:50:28.111+0800 don't know what to do with file "dump/prelude.json", skipping...
2025-04-25T22:50:28.111+0800 reading metadata for mydb.myCollection from dump/mydb/myCollection.metadata.json
2025-04-25T22:50:28.111+0800 reading metadata for test.myCollection from dump/test/myCollection.metadata.json
2025-04-25T22:50:28.111+0800 reading metadata for test.myComplexCollection from dump/test/myComplexCollection.metadata.json
2025-04-25T22:50:28.125+0800 restoring test.myCollection from dump/test/myCollection.bson
2025-04-25T22:50:28.134+0800 restoring mydb.myCollection from dump/mydb/myCollection.bson
2025-04-25T22:50:28.136+0800 finished restoring test.myCollection (3 documents, 0 failures)
2025-04-25T22:50:28.140+0800 restoring test.myComplexCollection from dump/test/myComplexCollection.bson
2025-04-25T22:50:28.148+0800 finished restoring mydb.myCollection (3 documents, 0 failures)
2025-04-25T22:50:28.151+0800 finished restoring test.myComplexCollection (0 documents)
2025-04-25T22:50:28.151+0800 no indexes to restore for collection mydb.myCollection
2025-04-25T22:50:28.151+0800 no indexes to restore for collection test.myCollection
2025-04-25T22:50:28.151+0800 no indexes to restore for collection test.myComplexCollection
2025-04-25T22:50:28.151+0800 6 document(s) restored successfully. 0 document(s) failed to restore.
MongoDB 用户管理
在 MongoDB 中进行用户管理涉及用户的创建、分配角色、认证和登录等操作。以下是使用 MongoDB Shell(mongosh
)进行用户管理的详细说明,包括创建用户、分配角色、认证和登录的具体步骤。
连接到 MongoDB
mongosh
切换到目标数据库
use test
创建用户
使用 db.createUser
命令创建用户并分配角色。
示例:创建名为 testuser
、密码为 password123
的用户,赋予 readWrite
和 dbAdmin
角色(需替换 <database_name>
为实际数据库名 )。
db.createUser({user: "testuser",pwd: "password123",roles: [{ role: "readWrite", db: "<database_name>" },{ role: "dbAdmin", db: "<database_name>" }]
})
验证用户
创建用户后,使用 db.auth
命令验证用户身份,传入用户名和密码进行认证。
db.auth("testuser", "password123")
启用身份验证
为确保只有经过身份验证的用户能访问 MongoDB,需启用身份验证。
编辑 MongoDB 配置文件 mongod.conf
,添加内容:
security:authorization: "enabled"
重启 MongoDB 服务使更改生效;
或在启动命令中添加认证参数
mongod --auth --dbpath /var/lib/mongo --logpath /var/log/mongodb/mongod.log --fork
使用用户身份登录
启用身份验证后,用创建的用户身份连接到 MongoDB
mongosh --host <hostname> --port <port> -u "testuser" -p "password123" --authenticationDatabase "<database_name>"
删除用户
使用 db.dropUser
命令删除指定用户,
示例删除 testuser
用户。
db.dropUser("testuser")
实例操作
完整示例操作流程:
启动 mongosh
并连接到服务器。
mongosh --host localhost --port 27017
切换到 testdb
数据库。
use testdb
创建 testuser
用户,赋予 testdb
数据库的 readWrite
和 read
角色。
db.createUser({user: "testuser",pwd: "password123",roles: [{ role: "readWrite", db: "testdb" },{ role: "read", db: "testdb" }]
})
重启 MongoDB 服务并开启认证
mongod --auth --dbpath /var/lib/mongo --logpath /var/log/mongodb/mongod.log --fork
使用Mongodb服务器开启认证
# 以 testuser 用户身份连接到 MongoDB,指定认证数据库为 testdb
mongosh --host localhost --port 27017 -u "testuser" -p "password123" --authenticationDatabase "testdb"# 切换到 testdb 数据库
test> use testdb;
switched to db testdb# 查看 testdb 数据库中的集合
testdb> show collections
去除认证后重启mongodb,登录删除testuser用户
# (需先去除认证并重启 mongod 后执行)删除 testuser 用户
db.dropUser("testuser")