文档数据库 MongoDB 版
文档数据库 MongoDB 版
文档指南
请输入
- 文档首页
文档数据库 MongoDB 版最佳实践数据迁移火山引擎 MongoDB 迁移至火山引擎 MongoDB
复制全文
下载 pdf火山引擎 MongoDB 迁移至火山引擎 MongoDB
文档反馈
问问助手本场景介绍如何在数据库传输服务 DTS 控制台创建火山引擎版 MongoDB 迁移至火山引擎版 MongoDB 任务。
前提条件
- 创建数据迁移任务之前，请确认源库和目标库的网络连通性与服务可用性。
- 您还可以根据预检查项中的说明，来检查源库和目标库中各迁移对象做相应准备。更多详情，请参见预检查项（MongoDB）。
注意事项
- 步方向与模式
- 为保障数据一致性，建议选择结构初始化 + 全量初始化 + 增量同步的完整链路。
- 若未勾选增量同步，数据同步期间请勿在源实例中写入新数据，否则可能导致数据不一致。
- 数据冲突处理
- 在同步过程中，若目标库中已存在同主键值或唯一键的记录，DTS 不会保留目标端的冲突数据，源端数据将直接覆盖目标端数据。具体表现如下：
- 表结构一致时： 源端数据覆盖目标表中主键或唯一键相同的记录。
- 表结构不一致时： 可能导致无法初始化数据，仅同步部分列。
- 通过表名映射、删除或重命名目标库中同名表的方式，避免数据覆盖带来的不一致风险。
- DDL 操作约束
- 在同步过程中，若源端执行了 CREATE TABLE、RENAME TABLE 操作，请在配置阶段的同步对象中勾选该表所在的整库（或该表 RENAME 到的整库），否则新建或重命名后的表不会同步到目标端。
- 在预检查阶段，如果选择忽略告警并强制启动任务，可能导致数据不一致，带来业务风险。关于预检查的具体说明，请参见预检查项（MongoDB）。
- 存储空间说明
- 全量初始化会并发执行 INSERT 操作，导致目标库的集合产生碎片。因此，全量初始化完成后，目标库的集合存储空间会大于源库，属于正常现象。
- 功能状态说明
- 云盘版 MongoDB 实例的同步功能目前处于邀测阶段。如需使用该功能，请提交工单联系技术支持进行申请。
限制条件
应用限制
数据库最小权限策略
用于数据迁移的账号需具备以下权限：
- 如果源库是分片集群类型的实例，则需要有源库的 root 权限。
说明
在需要进行增量迁移分片集数据时，仅当增量数据获取方式选择 ChangeStream 时，源库账号需要 Change Stream 权限。
- 如果源库是副本集类型的实例，则需要有以下权限。
- 源库待迁移对象 FIND、buildInfo、serverStatus、listDatabases 权限。
- 源库账号需具备待同步库、Config 库、admin 库和 local 库的读权限。
- 目标库账号需要具备目标库的读和写权限，以及 local 库的读权限。
操作步骤
- 登录 DTS 控制台。
- 在顶部菜单栏，选择项目和地域。
- 在左侧导航栏，单击数据迁移。
- 在迁移任务列表页面，单击创建任务。
- 在创建迁移任务页面的配置源库及目标库配置向导页面，配置以下参数信息。
- 类别参数说明基本信息任务名称（可选）自定义迁移任务名称。长度需在 256 个字符内。说明若未进行设置，系统将默认生成一个以 dts- 开头命名的任务。链路规格按需选择迁移任务的链路规格，当前支持 Compact、Medium 和 Standard。说明源库配置选择已有数据源您可以按需选择是否使用已录入的实例：
- 使用已录入实例：单击选择已有数据源，在选择数据源控制面板，从地域下拉列表中选择目标地域，然后选择目标数据源。支持通过数据源名称和 ID 选择数据源。关于数据源的创建方法，请参见数据源管理。
- 不使用已录入实例：如果不使用已录入的实例，那么您需要配置以下数据库实例信息。
实例类型选择 MongoDB。接入方式选择火山引擎版 MongoDB。地域选择目标实例所属地域。架构按需选择目标 MongoDB 实例的架构类型，当前支持选择副本集和分片集群。增量数据获取方式在架构选择分片集群时支持设置增量数据获取方式。按需选择增量数据的获取方式，支持以下选择：- ChangeStream：该获取方式提供从数据集（数据库、集合或管道）中获取特定类型已修改数据的改变事件的方法。例如插入、更新或删除事件。如果选择该获取方式，那么实例的版本需大于等于 3.6。
- Oplog：该获取方式表示直接获取 MongoD 操作日志。对于 MongoDB 分片集，选择该获取方式后需要填写所有分片地址。该方式相较于 ChangeStream 能提供更好的同步性能。
- None：选择 None 后无法选择增量迁移，只能选择全量迁移。
是否跨火山引擎账号按需选择是否跨账号传输数据，取值如下：- 本账号：选择本账号时，表示仅在本账号内实现数据传输。
- 跨账号：选择跨账号时，表示将实现两个账号间的数据传输。
说明- 在进行跨账号传输数据时，您需要通过目标端所在的账号登录数据库传输服务 DTS 控制台。
- 跨账号进行数据传输前，您需要在源端的主账号内创建 IAM 角色并授权。详细操作，请参见如何授权用户实现跨账号传输数据。
- 如需通过跨账号实现数据传输，您还需要同时配置跨账号 ID 和跨账号角色参数信息。
跨账号 ID输入源库所属的火山引擎账号 ID。跨账号角色输入已授权 DTS 访问跨账号资源的 IAM 角色。MongoDB 实例从下拉列表中选择目标 MongoDB 的实例。说明您也可以通过实例 ID 或名称搜索目标实例。数据库账号输入目标实例的数据库账号。数据库密码输入目标实例数据库账号对应的密码。测试连接单击测试连接，验证是否成功连接实例。 当测试连接失败时，根据失败提示信息修改相关配置后，再次单击测试连接，验证是否可以成功连接实例。具体提示信息如下：- 连接认证失败，请检查用户名和密码是否正确：当出现该报错提示时，您需要确认用户名和密码的准确性。
- 连接认证失败，无法正常创建连接，请联系客服：当出现该报错提示时，请提交工单联系技术支持。
目标库配置选择已有数据源您可以按需选择是否使用已录入的实例：- 使用已录入实例：单击选择已有数据源，在选择数据源控制面板，从地域下拉列表中选择目标地域，然后选择目标数据源。支持通过数据源名称和 ID 选择数据源。关于数据源的创建方法，请参见数据源管理。
- 不使用已录入实例：如果不使用已录入的实例，那么您需要配置以下数据库实例信息。
实例类型选择 MongoDB。接入方式选择火山引擎版 MongoDB。架构按需选择目标 MongoDB 实例的架构类型，当前支持选择副本集和分片集群。地域选择目标实例所属地域。MongoDB 实例从下拉列表中选择目标 MongoDB 的实例。说明您也可以通过实例 ID 或名称搜索目标实例。数据库账号输入目标实例的数据库账号。数据库密码输入目标实例数据库账号对应的密码。测试连接单击测试连接，验证是否成功连接实例。当测试连接失败时，根据失败提示信息修改相关配置后，再次单击测试连接，验证是否可以成功连接实例。具体提示信息如下：- 连接认证失败，请检查用户名和密码是否正确：当出现该报错提示时，您需要确认用户名和密码的准确性。
- 连接认证失败，无法正常创建连接，请联系客服：当出现该报错提示时，请提交工单联系技术支持。
Project 与计费项目标签（可选）单击添加标签，为实例添加标签，标签可帮您实现云资源的分类、云资源的访问控制、账单与成本分摊等。标签由一个键值对（Key-Value）组成，用于标识云资源，可以帮助您从不同维度（例如用途、所有者等）对具有相同特征的云资源进行分类，便于筛选和聚合，从而轻松管理云上资源。关于标签的详细信息，请参见标签概述。标签的键值对规则如下：- 键
- 支持任何语言、文字、数字、空格或符号（_.:/=+-@）。
- 大小写敏感，且长度在 1~128 个字符内。
- 使用 UTF-8 编码的 Unicode 格式。
- 不支持设置以 volc: 开头的任何形式的 Key，例如 Volc:、VOLC: 等。
- （可选）值
- 支持任何语言、文字、数字、空格或符号（_.:/=+-@）。
- 大小写敏感，且长度在 0~256 个字符内。
- 使用 UTF-8 编码的 Unicode 格式。
说明- 支持模糊搜索选择已有标签键和标签值。
- 单次最多可给任务绑定 20 个标签。单个任务最多可绑定 50 个标签。
- 同一个资源拥有的标签 Key 不可重复，且一个标签 Key 只有一个值 Value。
计费方式当前仅支持按量计费，您无需选择。说明
- 单击下一步:配置迁移对象。
- 在配置迁移对象配置向导页面，配置相关参数信息，如下表所示。
说明
- 若暂时不需要启动迁移任务，您可以在完成迁移对象配置后，单击页面右下角的保存。
- 保存后会跳转回迁移任务列表页，此时任务状态为待启动，您可以在合适的时候再配置迁移任务。配置方法，请参见配置迁移任务。
- 参数说明迁移类型根据业务需要选择迁移类型，其中：
- 若仅需要全量迁移，可以同时选中结构迁移和全量迁移。
- 若需要进行不停机迁移，可以同时选中结构迁移、全量迁移和增量迁移。
说明若未选中增量迁移，数据迁移期间请勿在源实例中写入新的数据，以确保数据一致性。迁移对象在迁移对象区域中勾选需要迁移的对象，支持通过普通搜索和全局搜索方式查询目标对象。同时，您可以在已选择对象区域中实现以下操作：- 重命名库或表：单击目标库、表和视图后的笔状图标，重命名库、表和视图。如果在迁移对象区域勾选了整库，则在已选择对象区域仅支持修改库名，且不支持展开该数据库。单击批量映射，可以批量修改库或表名，更多信息请参见库表批量映射。
- 筛选删除不需要的目标：在已选择对象区域的搜索框内支持模糊搜索，批量删除不需要的数据库、表等目标。
错误重试时间在迁移任务中，当源库和目标库断连后导致迁移任务失败时，会立即在指定时间内多次重试连接源库和目标库。取值范围：600~86400，单位：秒(s)。默认值为 600 秒。全量迁移速率按需设置全量迁移速率。防止在迁移速率过高时，影响源库的性能，您可以根据源库和目标库的读写压力情况适当调整以下参数：- 每秒迁移的行数：按需开启并设置每秒迁移的行数。默认值 100000，取值范围 1~100000。
- 每秒迁移的数据量：按需开启并设置每秒迁移的数据量。默认值 25000，取值范围 1~100000，单位 KB。
- 迁移任务并发数：按需设置迁移任务的并发数。默认值 8，取值范围 1~64。
- 单击数据校验配置。
- 在创建迁移任务页面的配置数据校验配置向导页面，配置以下参数信息。
-
- 单击预检查。
- （可选）当创建的任务已有预检查时，您可以根据以下提示确认是否重新发起预检查，当需要重新发起预检查时，请在是否重新发起预检查对话框，单击确定。
- 若源端和目标端的数据库实例未做修改，则无需再次发起预检查。
- 如果修改了源端、目标端的数据库实例信息或迁移任务的参数配置，那么建议您重新发起预检查，否则可能会导致任务启动失败或者任务中断。
- 在预检查配置向导页面，根据检查结果执行以下操作：
- 单击预检查结果操作列的详情，查看详细的告警和失败信息，并根据告警或失败信息修改库表后，单击重试。
- 单击操作列的忽略，忽略本次告警继续启动迁移任务。同时，也可以单击忽略全部，一键忽略全部告警信息。
- 在预检查页面右下角，单击确认订单。
- 在确认订单配置向导页面，再次确认配置信息。阅读《数据库产品和服务条款》并勾选我已阅读并同意《数据库产品和服务条款》，然后执行以下操作。
- 单击创建并启动任务，成功创建数据迁移任务后，将立即启动数据迁移。
- 单击创建任务，成功创建数据迁移任务后，需要您在合适的时机手动启动数据迁移。
相关 API
最近更新时间：2026.10.14 14:55:55
这个页面对您有帮助吗？
有用
有用
无用
无用