vv13
博客关于我

MongoDB 数据迁移演练

为了将本地的 Docker 中的 MongoDB 中的测试数据迁移到开发服务器,本文记录了使用 MongoDB 自带的 mongodumpmongorestore 命令工具进行迁移的过程,以免遗忘。

环境准备

为了模拟整个命令执行的过程,首先需要确保本地具有 Docker 的环境,我们在这里通过初始化两个 MongoDB 容器来进行演练。

然后让我们来做一些环境初始化的工作,通过脚本进行初始化两个容器:

docker run -d --name migrate-from \
    -e MONGO_INITDB_ROOT_USERNAME=migrate \
    -e MONGO_INITDB_ROOT_PASSWORD=from \
        -p 27018:27017 \
    mongo:4.2
docker run -d --name migrate-to \
    -e MONGO_INITDB_ROOT_USERNAME=migrate \
    -e MONGO_INITDB_ROOT_PASSWORD=to \
        -p 27019:27017 \
    mongo:4.2

现在我们拥有两台 MonogDB 服务了,Connect Url 分别为:

  • mongodb://migrate:from@localhost:27018/admin
  • mongodb://migrate:to@localhost:27019/admin

对应容器状态:

➜ docker ps
CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS              PORTS                               NAMES
c64675fb8f63        mongo:4.2           "docker-entrypoint.s…"   12 minutes ago      Up 12 minutes       0.0.0.0:27018->27017/tcp            migrate-from
81bb50471092        mongo:4.2           "docker-entrypoint.s…"   12 minutes ago      Up 12 minutes       0.0.0.0:27019->27017/tcp            migrate-to

现在进入到容器内,在 migrate-from 数据库中添加一条待迁移的数据:

docker exec -it migrate-from /bin/bash # 进入容器内部
mongo --port 27017  --authenticationDatabase "admin" -u "migrate" -p "from" # 进入到数据库命令洁面
use admin
db.createCollection('migrate')
db.migrate.insertOne({name: 'hello', value: 'world'})

此时可在 Mongo 客户端中进行查看数据操作:

0

数据备份

备份 MongoDB 的数据有许多种方案,在这篇文章中仅仅是简单的使用 mongodump ,它是官方提供的一个数据库备份工具,适合处理数据量较小的数据库。

常用的 mongodump 命令选项为:

  • --uri=<connectionString>,直接指定连接字符串
  • --host=<hostname><:port>, -h=<hostname><:port> ,主机名,若不指定,则默认指向 localhost 的27017 端口
  • --port=<port> ,端口号,默认27017
  • --authenticationDatabase=<dbname> ,指定授权认证数据库,默认授权认证数据库为 admin
  • --username=<username>, -u=<username> ,用于授权认证的用户名
  • --password=<password>, -p=<password> ,用户授权认证的密码
  • -out=<path>, -o=<path> ,指定数据库生成 BSON 备份文件输出的位置
  • ...

那么回到之前 migrate-from 容器,我们来执行备份命令,连接数据服务并将文件备份到 /backup 目录:

root@c64675fb8f63:/# mongodump --uri=mongodb://migrate:from@localhost:27017/admin -o /dump
2020-10-13T15:42:24.200+0000    writing admin.system.users to /dump/admin/system.users.bson
2020-10-13T15:42:24.201+0000    done dumping admin.system.users (1 document)
2020-10-13T15:42:24.202+0000    writing admin.system.version to /dump/admin/system.version.bson
2020-10-13T15:42:24.203+0000    done dumping admin.system.version (2 documents)
2020-10-13T15:42:24.204+0000    writing admin.migrate to /dump/admin/migrate.bson
2020-10-13T15:42:24.205+0000    done dumping admin.migrate (1 document)  

当备份完成后,我们还需要做一项工作,将生成的备份文件从容器 migrate-from 拷贝到 migrate-to,在这里我们会使用到 docker cp 命令,先来简单看看用法:

docker cp [OPTIONS] CONTAINER:SRC_PATH DEST_PATH|-
docker cp [OPTIONS] SRC_PATH|- CONTAINER:DEST_PATH

在这个简单场景里,我们把容器内的备份文件拷贝到宿主机,再将宿主机拷贝到另一个容器即可:

docker cp migrate-from:/dump  ./dump
docker cp ./dump migrate-to:/dump
rm -rf ./dump

数据迁移

最后一步,通过 mongorestore 即可完成数据的迁移,该命令常用的参数如下:

  • urihostportauthenticationDatabaseusernamepassword 等与 mongodump 使用方法一致
  • -db=<database>, -d=<database> ,指定数据库的名称,如果数据库不存在 MongoDB 会自动创建
  • -collection=<collection>, -c=<collection> ,指定集合的名称,用于从单个 BSON 对应的集合恢复数据时使用
  • ...

现在,就来完成最后的一步操作吧,将备份文件恢复到 MongoDB 数据中:

mongorestore /dump --uri=mongodb://migrate:to@localhost:27017/admin

执行完成后,使用 robo3T 或者任何客户端系统查看一下结果吧:

0

最后不要忘记清理容器哦。

写到最后

本文主要是在介绍 mongodumpmongorestore 两个命令的基本操作,可想而知,还有更多复杂的场景与高效的方法去做这件事情,之后希望能遇到更多的业务场景去做实施与优化吧。

参考文章