本文介绍如何使用数据传输服务DTS(Data Transmission Service),将华为云文档数据库迁移至阿里云MongoDB实例。DTS支持全量数据迁移及增量数据迁移,同时使用这两种迁移类型可以实现在本地应用不停服的情况下,平滑地完成数据库迁移。
前提条件
- 华为云文档数据库为单节点实例或副本集实例。 说明 使用DTS迁移单节点实例至阿里云时,不支持增量数据迁移。
- 阿里云MongoDB实例的存储空间应大于华为云文档数据库的存储空间。
注意事项
- DTS在执行全量数据迁移时将占用源库和目标库一定的资源,可能会导致数据库服务器负载上升。如果数据库业务量较大或服务器规格较低,可能会加重数据库压力,甚至导致数据库服务不可用。建议您在执行数据迁移前谨慎评估,在业务低峰期执行数据迁移。
- 对于迁移失败的任务,DTS会触发自动恢复。当您需要将业务切换至目标实例时,请务必先结束或释放该任务,避免该任务被自动恢复后,导致源端数据覆盖目标实例的数据。
- 不支持迁移admin和local数据库。
- 阿里云MongoDB实例支持的版本与存储引擎请参见版本及存储引擎,如需跨版本或跨引擎迁移,请提前确认兼容性。
- 由于DTS写入数据的逻辑为并发写入,所以会导致目标端占用的存储空间比源端大5%~10%。
- 请确保目标端MongoDB没有与源端相同的主键(默认为_id),否则会导致数据丢失。若目标端有与源端相同的主键,请在不影响业务的前提条件下清空目标端的相关数据(删掉目标端中与源端相同_id的文档)。
费用说明
迁移类型 | 链路配置费用 | 公网流量费用 |
---|---|---|
全量数据迁移 | 不收费。 | 仅当通过公网将数据迁移出阿里云时收费,详情请参见DTS产品定价。 |
增量数据迁移 | 收费,详情请参见DTS产品定价。 |
迁移类型说明
迁移类型 | 说明 |
---|---|
全量数据迁移 | 将源MongoDB数据库迁移对象的存量数据全部迁移到目标MongoDB数据库中。 说明 支持迁移database、collection和index。 |
增量数据迁移 | 在全量迁移的基础上,将源MongoDB数据库的增量更新数据同步到目标MongoDB数据库中。 说明
|
数据库账号的权限要求
迁移数据源 | 全量数据迁移 | 增量数据迁移 |
---|---|---|
华为云文档数据库 | 待迁移库的read权限 | 待迁移库、admin库和local库的read权限 |
阿里云MongoDB实例 | 目标库的readWrite权限 | 目标库的readWrite权限 |
数据库账号创建及授权方法:
- 阿里云MongoDB实例请参见使用DMS管理MongoDB数据库用户。
- 华为云文档数据库请参见MongoDB Create User说明。
准备工作
- 登录华为云文档数据库控制台。
- 单击实例ID,进入实例管理页面。
- 在基本信息页签的实例信息区域框中,单击SSL的滑块关闭SSL功能。 警告 在关闭SSL功能时,实例会进行一次重启,建议您提前做好业务安排并确保应用有重连机制。
- 在基本信息页签的节点信息模块,单击绑定弹性IP。 说明 您可以为Secondary或Primary角色的节点绑定公网IP地址。
- Primary节点:副本集实例中的主节点,该节点的数据库支持读写。
- Secondary节点:副本集实例中的从节点,该节点的数据库仅支持只读。
- 在基本信息页签的网络区域框中,单击安全组ID。
- 在安全组设置页面中,将DTS服务器的IP地址段添加至入方向规则中。 说明
- 华为云文档数据库默认的端口为8635,如您修改过,请填入修改后的数据库端口号。
- 在DTS服务器的IP地址段文档中,根据目标实例的地域信息,选择需要添加的IP地址段。例如,源实例的地域为杭州,目标实例的地域为深圳,那么需要将深圳地区的DTS IP地址段加入至源实例的白名单中。
操作步骤
- 登录数据传输控制台。说明 若数据传输控制台自动跳转至数据管理DMS控制台,您可以在右下角的
中单击
,返回至旧版数据传输控制台。
- 在左侧导航栏,单击数据迁移。
- 在迁移任务列表页面顶部,选择目标MongoDB实例所属地域。
- 单击右上角的创建迁移任务。
- 配置迁移任务的源库及目标库信息。
类别 配置 说明 无 任务名称 DTS会自动生成一个任务名称,建议配置具有业务意义的名称(无唯一性要求),便于后续识别。 源库信息 实例类型 选择有公网IP的自建数据库。 实例地区 当实例类型选择为有公网IP的自建数据库时,实例地区无需设置。 数据库类型 选择MongoDB。 主机名或IP地址 填入在迁移前准备工作中,为华为云文档数据库绑定的弹性公网IP地址。 端口 填入华为云文档数据库的端口号,本案例中填入8635。 数据库名称 填入鉴权数据库名,默认为admin。 数据库账号 填入连接华为云文档数据库的数据库账号,权限要求请参见数据库账号的权限要求。 数据库密码 填入连接华为云文档数据库的账号对应的密码。 说明 源库信息填写完毕后,您可以单击数据库密码后的测试连接来验证填入的源库信息是否正确。源库信息填写正确则提示测试通过,如提示测试失败,单击测试失败后的诊断,根据提示调整填写的源库信息。连接方式 选择非加密连接。 说明 只有在迁移MongoDB Atlas数据库时,才能选择SSL安全连接。目标库信息 实例类型 选择MongoDB实例。 实例地区 选择阿里云MongoDB实例所在地域。 MongoDB实例ID 选择阿里云MongoDB实例ID。 数据库名称 填入鉴权数据库名,默认为admin。 数据库账号 填入连接阿里云MongoDB实例的数据库账号,权限要求请参见数据库账号的权限要求。 数据库密码 填入连接阿里云MongoDB实例的数据库账号对应的密码。 说明 目标库信息填写完毕后,您可以单击数据库密码后的测试连接来验证填入的目标库信息是否正确。目标库信息填写正确则提示测试通过,如提示测试失败,单击测试失败后的诊断,根据提示调整填写的目标库信息。 - 配置完成后,单击页面右下角的授权白名单并进入下一步。警告 DTS自动添加或您手动添加DTS服务的公网IP地址段可能会存在安全风险,一旦使用本产品代表您已理解和确认其中可能存在的安全风险,并且需要您做好基本的安全防护,包括但不限于加强账号密码强度防范、限制各网段开放的端口号、内部各API使用鉴权方式通信、定期检查并限制不需要的网段,或者使用通过内网(专线/VPN网关/智能网关)的方式接入。
- 选择迁移对象及迁移类型。
配置 说明 迁移类型 - 如果只需要进行全量迁移,则选中全量数据迁移。 说明 迁移单节点的华为云文档数据库时,仅支持全量数据迁移。为保障数据一致性,全量数据迁移期间请勿在源库中写入新的数据。
- 如果需要进行不停机迁移,则同时选中全量数据迁移和增量数据迁移。
迁移对象 - 在迁移对象框中单击待迁移对象,然后单击
图标将其移动到已选择对象框。
说明 不支持迁移admin和local数据库。 - 迁移对象选择的粒度为database、collection或function。
- 默认情况下,迁移完成后,迁移对象的名称保持不变。如果您需要迁移对象在目标数据库中的名称不同,那么需要使用DTS提供的对象名映射功能。使用方法请参见库表列映射。
映射名称更改 如需更改迁移对象在目标实例中的名称,请使用对象名映射功能,详情请参见库表列映射。 源、目标库无法连接重试时间 默认重试12小时,您也可以自定义重试时间。如果DTS在设置的时间内重新连接上源、目标库,迁移任务将自动恢复。否则,迁移任务将失败。 说明 由于连接重试期间,DTS将收取任务运行费用,建议您根据业务需要自定义重试时间,或者在源和目标库实例释放后尽快释放DTS实例。 - 如果只需要进行全量迁移,则选中全量数据迁移。
- 上述配置完成后,单击页面右下角的预检查并启动。 说明
- 在迁移任务正式启动之前,会先进行预检查。只有预检查通过后,才能成功启动迁移任务。
- 如果预检查失败,单击具体检查项后的
,查看失败详情。
- 您可以根据提示修复后重新进行预检查。
- 如无需修复告警检测项,您也可以选择确认屏蔽、忽略告警项并重新进行预检查,跳过告警检测项重新进行预检查。
- 预检查通过后,单击下一步。
- 在购买配置确认页面,选择链路规格并选中数据传输(按量付费)服务条款。
- 单击购买并启动,迁移任务正式开始。
- 全量数据迁移
请勿手动结束迁移任务,否则可能会导致数据不完整。您只需等待迁移任务完成即可,迁移任务会自动结束。
- 增量数据迁移
迁移任务不会自动结束,需要手动结束迁移任务。
说明 请选择合适的时间手动结束迁移任务,例如业务低峰期或准备将业务切换至MongoDB实例时。- 观察迁移任务的进度变更为增量迁移,并显示为无延迟状态时,将源库停写几分钟,此时增量迁移的状态可能会显示延迟的时间。
- 等待迁移任务的增量迁移再次进入无延迟状态,手动结束迁移任务。
- 全量数据迁移
- 将业务切换至阿里云MongoDB实例。
更多信息
当目标实例为分片集群实例时,您可以根据业务需要设置数据分片,详情请参见设置数据分片以充分利用Shard性能。