mongodump

MongoDB 逻辑备份工具

补充说明

mongodump 把 MongoDB 的库、集合和索引元数据导出成 BSON 文件，配合 mongorestore 恢复。它适合小中型数据集和跨版本迁移，大规模集群更常用文件系统快照。

常用示例

mongodump --uri="mongodb://app@127.0.0.1:27017/appdb?authSource=admin" --out=/backup
mongodump --uri="mongodb://app@db:27017" --db appdb --collection orders --out=/backup
mongodump --uri="mongodb://app@db:27017/appdb" --gzip --archive=/backup/appdb.gz
mongodump --uri="mongodb://app@db:27017/appdb" --oplog --out=/backup
mongodump --uri="mongodb://app@db:27017/appdb" --readPreference=secondary --out=/backup
mongodump --uri="mongodb://app@db:27017/appdb" --numParallelCollections=4 --out=/backup

易错点与排错

• --oplog 只在副本集上可用，用来保留备份期间的一致性；单机没有 oplog。
• 不加 --oplog 时，备份过程中写入的数据可能处于不一致状态。
• --archive 和 --out 不能同时用；归档模式默认单文件，配合 --gzip 才压缩。
• 认证库由 authSource 决定；用户建在 admin 时不要漏掉该参数。
• 默认不导出用户和角色；需要单独备份 admin.system.users 或使用 mongodump --db admin。
• 跨大版本恢复可能不兼容；先确认目标版本的兼容矩阵。
• 大库备份会占大量磁盘和 I/O；避开业务高峰，并监控副本集延迟。
• 备份文件要实际恢复演练；只看到文件生成不代表可恢复。

相关命令

• mongorestore — 恢复 BSON 备份
• mongosh — 连接与校验