本文介绍如何使用数据传输服务DTS(Data Transmission Service),将单节点架构的自建MongoDB数据库迁移至云数据库MongoDB中。DTS支持全量数据迁移和增量数据迁移,同时使用这两种迁移类型可以实现在不停服的情况下,平滑地完成数据库的迁移上云。
前提条件
- 自建MongoDB数据库的服务端口已开放至公网。
- 自建MongoDB数据库版本为3.0、3.2、3.4或4.0版本。
- 阿里云MongoDB实例的存储空间须大于自建MongoDB数据库占用的存储空间。
注意事项
- 为避免影响您的正常业务使用,请在业务低峰期进行数据迁移。
- 阿里云MongoDB实例支持的版本与存储引擎请参见版本及存储引擎,如需跨版本或跨引擎迁移,请提前确认兼容性。
- 单节点架构的自建MongoDB数据库,须开启Oplog才可以使用增量数据迁移功能。详情请参见增量数据迁移前的准备工作。
费用说明
迁移类型 |
链路配置费用 |
公网流量费用 |
全量数据迁移 |
不收费。 |
通过公网将数据迁移出阿里云时将收费,详情请参见产品定价。
|
增量数据迁移 |
收费,详情请参见产品定价。
|
迁移类型说明
- 全量数据迁移:将源MongoDB数据库迁移对象的存量数据全部迁移到目标MongoDB数据库中。
说明 支持database、collection、index的迁移。
- 增量数据迁移:在全量迁移的基础上,将源MongoDB数据库的增量更新数据同步到目标MongoDB数据库中。
说明
- 支持database、collection、index的新建和删除操作的同步。
- 支持document的新增、删除和更新操作的同步。
数据库账号的权限要求
迁移数据源 |
全量数据迁移 |
增量数据迁移 |
自建MongoDB数据库 |
待迁移库的read权限 |
待迁移库、admin库和local库的read权限 |
阿里云MongoDB数据库 |
目标库的readWrite权限 |
目标库的readWrite权限 |
数据库账号创建及授权方法:
增量数据迁移前的准备工作
使用DTS进行增量数据迁移时,需要开启源数据库的Oplog。如您仅需要全量数据迁移,可跳过本步骤。
说明 该操作需要重启MongoDB服务,请在业务低峰期操作。
- 使用Mongo Shell连接自建MongoDB数据库。
- 使用下述命令关闭MongoDB服务。
use admin
db.shutdownServer()
- 以副本集的方式在后台启动MongoDB服务。
mongod --port 27017 --dbpath /var/lib/mongodb --logpath /var/log/mongodb/mongod.log --replSet rs0 --bind_ip 0.0.0.0 --auth --fork
说明
- 该命令使用的数据库路径为/var/lib/mongodb,日志存储文件路径为/var/log/mongodb/mongod.log。您需要根据实际环境中的路径自行指定。
- 该命令使用0.0.0.0作为MongoDB数据库服务的绑定地址,即允许所有IP地址访问该数据库。迁移结束后可使用
kill
命令结束该进程,然后以原有的配置文件启动MongoDB服务。
- 该命令开启了认证功能,用户需要认证后才可以访问数据库。
- 使用Mongo Shell重新连接自建MongoDB数据库。
- 使用如下命令初始化副本集。
- 等待一段时间,当前节点的角色将转变为Primary。
说明 您可以通过rs.printReplicationInfo()
命令查看oplog的状态信息。
操作步骤
- 登录数据传输控制台。
- 在左侧导航栏,单击数据迁移。
- 在迁移任务列表页面顶部,选择阿里云MongoDB实例所属地域。
- 单击页面右上角的创建迁移任务。
- 配置迁移任务的源库及目标库信息。
类别 |
配置 |
说明 |
任务名称 |
- |
DTS会自动生成一个任务名称,建议配置具有业务意义的名称(无唯一性要求),便于后续识别。 |
源库信息 |
实例类型 |
选择有公网IP的自建数据库。
|
实例地区 |
当实例类型选择为有公网IP的自建数据库时,实例地区无需设置。
说明 如果您的自建数据库配置了白名单安全类设置,您需要在实例地区配置项后,单击获取DTS IP段来获取DTS服务器的IP地址,并将获取到的IP地址加入自建数据库的白名单安全设置中。
|
数据库类型 |
选择MongoDB。
|
主机名或IP地址 |
填入自建MongoDB数据库的访问地址,本案例中填入公网地址。 |
端口 |
填入自建MongoDB数据库的服务端口。 |
数据库名称 |
填入鉴权数据库名,即数据库账号所属的数据库。 |
数据库账号 |
填入自建MongoDB数据库的数据库账号,权限要求请参见数据库账号的权限要求。
|
数据库密码 |
填入该数据库账号对应的密码。
说明 源库信息填写完毕后,您可以单击数据库密码后的测试连接来验证填入的源库信息是否正确。源库信息填写正确则提示测试通过,如提示测试失败,单击测试失败后的诊断,根据提示调整填写的源库信息。
|
目标库信息 |
实例类型 |
选择MongoDB实例。
|
实例地区 |
选择目标MongoDB实例所在地域。 |
MongoDB实例ID |
选择目标MongoDB实例ID。 |
数据库名称 |
填入鉴权数据库名,即数据库账号所属的数据库。
说明 如果使用的数据库账号为root,那么对应的数据库名称即为admin。
|
数据库账号 |
填入MongoDB实例的数据库账号,权限要求请参见数据库账号的权限要求。
|
数据库密码 |
填入该数据库账号对应的密码。
说明 目标库信息填写完毕后,您可以单击数据库密码后的测试连接来验证填入的目标库信息是否正确。目标库信息填写正确则提示测试通过,如提示测试失败,单击测试失败后的诊断,根据提示调整填写的目标库信息。
|
- 完成上述配置后,单击页面右下角的授权白名单并进入下一步。
说明 此步骤会将DTS服务器的IP地址自动添加到目标MongoDB实例的白名单中,用于保障DTS服务器能够正常连接目标MongoDB实例。迁移完成后如不再需要可手动删除,详情请参见
白名单设置。
- 选择迁移对象及迁移类型。
配置 |
说明 |
迁移类型 |
- 如果只需要进行全量迁移,则勾选全量数据迁移。
说明 为保障数据一致性,全量数据迁移期间请勿在自建MongoDB数据库中写入新的数据。
- 如果需要进行不停机迁移,则同时选择全量数据迁移和增量数据迁移。
说明 迁移单节点架构的自建MongoDB数据库时,须提前开启Oplog才可以使用增量数据迁移功能,详情请参见 增量数据迁移前的准备工作。
|
迁移对象 |
- 在迁移对象框中单击待迁移的对象,然后单击将其移动到已选择对象框。
说明
- 不支持迁移admin和local数据库。
- config数据库属于系统内部数据库,如无特殊需求,请勿迁移config数据库。
- 迁移对象选择的粒度为database、collection/function。
- 默认情况下,迁移完成后,迁移对象的名称保持不变。如果您需要改变迁移对象在目标数据库中的名称,那么需要使用DTS提供的对象名映射功能。使用方法请参见库表列映射。
|
- 上述配置完成后,单击页面右下角的预检查并启动。
说明
- 在迁移任务正式启动之前,会先进行预检查。只有预检查通过后,才能成功启动迁移任务。
- 如果预检查失败,单击具体检查项后的,查看具体的失败详情。根据提示修复问题后,重新进行预检查。
- 预检查通过后,单击下一步。
- 在购买配置确认页面,选择链路规格并勾选数据传输(按量付费)服务条款。
- 单击购买并启动,迁移任务正式开始。
- 将业务切换至阿里云MongoDB实例。
评论