本教程介绍如何使用 和 创建备份并恢复数据。mongodumpmongorestore
如要将自托管部署的备份恢复到托管的 MongoDB Atlas 部署 ，请参阅使用 mongorestore 填充数据。
Considerations
部署
mongorestore和 实用程序可处理BSON数据转储，对于创建小型部署的备份非常有用。要实现弹性无中断备份，请将文件系统快照或区块级磁盘快照与MongoDBmongodump Atlas的云备份结合使用。
注意
使用 MongoDB Atlas 备份分片集群
性能影响
mongodump由于mongod 和mongorestore 会与运行的 实例交互，因此可能会影响数据库性能。这些工具会创建流量并强制数据库通过内存读取所有数据。当MongoDB读取不常访问的数据时，它会逐出经常访问的数据，从而降低数据库常规工作负载的性能。
使用MongoDB工具备份数据时，请遵循以下准则：
为文件添加标签以标识备份内容和备份时间。
如果
mongodump和mongorestore的性能影响不可接受，请使用替代方案，例如文件系统Atlas 备份快照或MongoDB Atlas中的云备份。为了确保
mongodump可以对副本集进行一致备份，必须使用--oplog选项来捕获备份操作期间收到的写入，或者停止备份期间对副本集的所有写入。对于分片集群副本集，请参阅使用数据库转储备份自管理分片集群。
通过将备份恢复到测试部署来验证备份。
要减少分片集群中备份不一致的情况，请在备份期间停止负载均衡器、所有写入操作和任何模式转换。
提示
有关详细信息，请参阅自管理部署的备份方法。有关MongoDB Database Tools参考，请参阅：
输出格式
mongorestore和 可以将数据输出到存档文件，这是多个BSON文件的单文件替代方案。存档文件是支持非连续文件写入的特殊用途格式。它们启用从MongoDB进行并发备份并恢复到MongoDB。存档文件还可以在备份和恢复期间优化磁盘mongodump I/O。
您还可以将存档文件写入标准输出 (stdout)。写入到标准输出可以实现通过网络进行数据迁移，减少磁盘 I/O，并提高MongoDB工具和存储引擎的并发性。
有关存档文件的更多信息，请参阅--archive 选项。
过期备份
备份提供数据库当前状态的快照。从备份中恢复时，恢复的数据库不包括备份后所做的任何更改，这可能会导致数据丢失。
步骤
备份数据库 mongodump
mongodump实用程序通过连接到运行的mongod 来备份数据。它可以备份整个服务器、数据库或集合，也可以使用查询来备份部分集合。mongodump local会从其输出中排除 数据库的内容。
不带任何参数，mongodump 会通过端口 27017 连接到本地系统上的MongoDB实例，并在当前目录中创建名为 dump/ 的数据库备份：
mongodump
要指定托管和端口，请使用以下方法之一：
在
--host中指定主机名和端口：mongodump --host="mongodb0.example.com:27017" <additional_options> 分别指定
--host和--port：mongodump --host="mongodb0.example.com" --port=27017 <additional_options>
要指定不同的输出目录，请使用--out （或-o ）：
mongodump --out=/opt/backup/mongodump-1
要将转储限制为特定数据库或集合，请使用--db 和--collection ：
mongodump --collection=myCollection --db=test
这会在当前目录的 dump/ 子目录中从 test数据库创建 myCollection 转储。
mongodump 覆盖输出文件夹中的现有文件（默认：dump/）。在多次运行之前，请备份或重命名输出文件夹。
必需的访问权限
mongodump要针对已启用访问权限控制的MongoDB 部署运行 find，您必须具有对每个要备份的数据库授予 动作的特权。内置backup 角色提供执行任一和所有数据库备份所需的特权。
backup 角色为运行数据库分析时存在的 system.profile 集合提供了额外的备份特权。
指定主机和端口
mongodump \ --host=mongodb1.example.net \ --port=3017 \ --username=user \ --password="pass" \ --out=/opt/backup/mongodump-1
在任何 mongodump 命令上指定用户名和密码以进行身份验证。
使用 Oplogs 创建备份
--oplog选项会在备份期间收集oplog条目，以便您可以将数据库恢复到备份完成时的状态。
使用 --oplog，mongodumpmongorestore --oplogReplay 复制源数据库中的所有数据以及从备份开始到结束的所有oplog条目。将其与 结合使用恢复反映mongodump 完成确切时刻的备份。
恢复数据库 mongorestore
mongorestore实用程序通过直接连接到运行的 来恢复由mongodump mongod创建的二进制备份。默认下，mongorestore dump/会在 目录中查找数据库备份，并可恢复整个备份或部分备份。
注意
所有 MongoDB 集合默认都有 UUID。MongoDB 恢复集合时，恢复的集合保留其原始 UUID。恢复不存在 UUID 的集合时，MongoDB 会为恢复的集合生成一个 UUID。
有关集合 UUID 的更多信息，请参阅集合。
要将 mongorestore 连接到活动的 mongod：
mongorestore --uri <connection string> <path to the backup>
示例，要从目录恢复：
mongorestore /opt/backup/mongodump-1
这会将备份恢复到 localhost:27017 上的 mongod实例。
访问控制
要将数据恢复到启用了访问权限控制的部署，如果数据不包括 system.profile集合数据，并且您在没有 restore选项的情况下运行 ，mongorestore --oplogReplay角色将提供必要的特权。
如果备份数据包含system.profile 集合数据或者使用--oplogReplay 运行，则需要额外权限：
| 如果备份数据包括 内置角色 |
| 要使用 仅授予必须使用 运行 |
指定主机和端口
默认下，mongorestore 连接到 localhost:27017。要恢复到不同的托管或端口，请使用 --host 和 --port：
mongorestore --host=mongodb1.example.net --port=3017
--username要进行身份验证，请包含--authenticationDatabase 和--password 。省略 以让mongorestore 提示输入密码：
mongorestore \ --host=mongodb1.example.net \ --port=3017 \ --username=user \ --authenticationDatabase=admin \ /opt/backup/mongodump-1
使用 Oplog 文件恢复数据
要捕获 mongodump运行时发生的写入，请使用 --oplog。mongodump 会为运行期间的每次写入创建一个 oplog.bson文件，其中包含oplog条目。恢复时使用 --oplogReplay 应用这些操作。
有关示例，请参阅 mongodump 示例和 mongorestore 示例。
mongorestore --oplogReplay 从 oplog.bson 开始恢复所有数据，但不支持恢复到任意时间点。使用它可确保恢复的数据反映 mongodump --oplog运行期间发生的任何写入。
注意
--oplog 旨在与副本集一起使用。对于分片集群，包括作为分片环境一部分的副本集，请参阅使用数据库转储备份自管理分片集群。
使用--objcheck 在插入期间验证文档完整性，或使用--drop 在恢复之前删除每个集合。