--- title: "查看数据迁移项目的详情 | OceanBase 文档中心" description: 查看数据迁移项目的详情 启动数据迁移项目后，您可以在数据迁移项目的详情页面查看相应项目的基本信息、项目执行的进度和状态等信息。 进入详情页面 登录 OMS 控制台。 在左侧导航栏，单击 数据迁移 。 在 数据迁移 页面，单击目标项目的名称，进入详情页面查看其 基本信息 和 迁移详情 。 您可以在 数据迁移 页面，根据… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*L03BS6f-o40AAAAAAAAAAAAADiGDAQ/original) 迁移服务 OMSV 4.0.2 企业版 # 查看数据迁移项目的详情 更新时间：2026-04-14 15:35:47 启动数据迁移项目后，您可以在数据迁移项目的详情页面查看相应项目的基本信息、项目执行的进度和状态等信息。 ## 进入详情页面 1. 登录 OMS 控制台。 2. 在左侧导航栏，单击 **数据迁移**。 3. 在 **数据迁移** 页面，单击目标项目的名称，进入详情页面查看其 **基本信息** 和 **迁移详情**。 您可以在 **数据迁移** 页面，根据标签、状态、类型和关键字等，搜索目标数据迁移项目。数据迁移项目的状态包括： - **未启动**：表示数据迁移项目尚未启动，您可以在对应的操作列中单击 **启动**。 - **运行中**：数据迁移项目运行中，状态右侧展示了数据迁移的计划和当前进度。 - **修改中**：数据迁移项目正在被修改迁移对象。 - **合并中**：被修改迁移对象的数据迁移项目与修改迁移对象任务进行合并的过程。 - **已暂停**：数据迁移项目已被手动中止，您可以在对应的操作列中单击 **恢复**，从中止的子任务开始继续执行迁移。 - **失败**：数据迁移项目执行失败，状态右侧展示该项目失败的具体环节。单击数据迁移项目的名称，您可以在详情页面查看具体的报错信息。 - **已完成**：数据迁移项目已成功执行完毕，OMS 已按照您预设的迁移模式将指定的数据内容迁移至目标库中。 - **释放中**：数据迁移项目正在被释放。释放中的数据迁移项目不能进行任何操作。 - **已释放**：数据迁移项目已经成功释放。释放后，OMS 会终止当前的迁移和增量同步项目。 ## 查看基本信息 **基本信息** 区域为您展示当前数据迁移项目相关的基本信息。 | **参数** | **描述** | | --- | --- | | ID | 数据迁移项目的唯一 ID 标识。 | | 迁移类型 | 创建数据迁移项目时，选择的迁移类型。 | | 告警等级 | 显示当前项目的告警等级。OMS 支持的告警级别包括 **无保护**、**高保护**、**中保护** 和 **低保护**，设置的详情请参见 [告警设置](https://www.oceanbase.com/docs/enterprise-oms-doc-cn-10000000001904422)。 | | 创建人 | 当前数据迁移项目的创建人。 | | 创建时间 | 当前数据迁移项目的创建时间。 | | 全量迁移并发速度 | 包括 **平稳**、**正常** 和 **快速**。全量迁移的性能不同，全量迁移任务所需要的资源也不同。 | | 全量校验并发速度 | 包括 **平稳**、**正常** 和 **快速**。不同档位对源端和目标端的资源消耗不同。 | | 连接详情 | 单击 **连接详情**，查看数据迁移项目源端和目标端的连接信息。 | 您可以进行以下操作： - 查看迁移对象 单击页面右上角的 **查看对象**，查看当前数据迁移项目的迁移对象列表。您还可以在数据迁移项目运行过程中修改迁移对象。详情请参见 [查看和修改迁移对象](https://www.oceanbase.com/docs/enterprise-oms-doc-cn-10000000001903141)。 - 查看组件监控 单击页面右上角的 **查看组件监控**，查看 Store、Incr-Sync、Full-Import 和 Full-Verification 等组件的信息。您还可以对各组件进行以下操作： - 启动组件：单击未运行的目标组件后的 **启动**，在对话框中，单击 **确定**。 - 暂停组件：单击运行中的目标组件后的 **暂停**，在对话框中，单击 **确定**。 - 更新组件：单击目标组件后的 **更新**，在 **更新配置** 页面，修改相应配置后，单击 **更新**。 #### 注意 此处的更新包含重启操作，请谨慎操作。 - 查看日志：单击目标组件后的 **查看日志**， **查看日志** 页面为您展示最近的相关运行中产生的日志。您可以进行 **查找**、**下载** 和 **复制**。 - 查看或修改参数配置 - 如果是处于 **运行中** 状态的数据迁移项目，请单击页面右上角的 **更多操作** > **查看参数配置**，查看创建数据迁移项目时的配置参数。 - 如果是处于 **未启动**、**已暂停** 和 **失败** 状态的数据迁移项目，请单击页面右上角的 **更多操作** > **修改参数配置**。在 **修改参数配置** 对话框，重新配置目标参数，单击 **确定**。 此处支持修改的具体参数和数据迁移项目的类型，以及任务运行的阶段有关，不同的运行阶段支持修改的参数不同。 - 下载对象配置信息 OMS 支持下载数据迁移项目的配置信息，以批量导入的格式输出。详情请参见 [下载和导入迁移对象配置](https://www.oceanbase.com/docs/enterprise-oms-doc-cn-10000000001904441)。 ## 查看迁移详情 **迁移详情** 区域为您展示当前项目中，所有环节子任务的执行状态、进度、启动时间、完成时间和总计耗时等信息。 ### 结构迁移 负责迁移源库中的数据对象定义（表、索引、约束、注释和视图等）至目标库中，会自动过滤临时表。当源端数据库非 OceanBase 数据库时，会依据目标 OceanBase 租户类型的语法定义标准进行数据类型和 SQL 语法的自动转换和拼装，然后复制至目标库中。 如果您在运行数据迁移项目时，进入了正向切换步骤，OMS 会根据数据迁移项目的类型，自动删除隐藏列和唯一索引。详情请参见 [数据迁移服务隐藏列机制说明](https://www.oceanbase.com/docs/enterprise-oms-doc-cn-10000000001904438)。 您可以在 **结构迁移** 页面，查看结构迁移的整体状态、启动时间、结束时间、总计耗时，以及库、表和视图的迁移进度。同时，您可以对目标对象进行以下操作： - 查看创建语法：在 **库** 或 **表** 页签下，单击目标对象后的 **查看**，即可查看库、表或索引的创建语法。 如果表创建语法完全兼容，为您展示在 OBServer 节点执行的 DDL 语法。不完全兼容，则展示转换后的创建语法。 - 修改创建语法并重试：运行失败的 DDL 和报错，您可以检查并修改该条 DDL 转换结果的定义，再次迁移至目标端。 - 重试/重试全部失败对象：失败的结构迁移任务，您可以依次进行重试，也可以单击页签右上角的 **重试全部失败对象**。 - 跳过/批量跳过：失败的结构迁移任务，您可以依次跳过。您也可以批量选择需要跳过的对象，单击右上角的 **批量跳过**。跳过对象时，索引会一并跳过。 - 移除/批量移除：失败的结构迁移任务，您可以依次进行移除。您也可以批量选择需要移除的对象，单击右上角的 **批量移除**。移除对象时，索引会一并移除。 - 查看详情：失败的结构迁移任务，展示 DDL 语句和 OBServer 节点上执行的错误信息。 ### 全量迁移 迁移源库表的存量数据至目标库对应的表中。您可以在 **全量迁移** 页面，根据源库和目标库进行筛选，或勾选 **查看有问题的对象**，筛选阻碍整体迁移进度的对象。您还可以查看 **表对象**、**表索引** 和 **全量迁移性能**。只有表对象和表索引均迁移完成，全量迁移的状态才会显示已完成。 - 在 **表对象** 页签，您可以查看对象名称、源库、目标库、预估数据量、已完成数据量和对应的状态。 - 在 **表索引** 页签，您可以查看表对象、源库、目标库、创建时间、结束时间、耗时及其对应的状态。同时，您可以查看索引的创建语法，并移除无需使用的索引。 - 在 **全量迁移性能** 页签，您可以图形化查看 **源端 RPS**、**目标端 RPS**、**源端迁移流量**、**目标端迁移流量**、**源端平均读取时间**、**源端平均切片时间** 和 **目标端平均写入时间**，以及性能基准等性能数据，帮助您有效识别性能相关问题。 全量迁移加上增量同步，可以确保目标端数据库与源端数据库的最终一致性。如果全量迁移过程中有失败的对象，会为您展示具体的失败原因。 #### 注意 - 如果您在选择 **迁移类型** 时未配置 **结构迁移**，则全量迁移时，OMS 会以源端和目标端匹配的字段进行迁移，不会检查表结构是否一致。 - 在全量迁移完成之后，且后续步骤已启动的情况下，不允许在 **运维监控** > **组件** > **Full-Verification** 页面，单击目标 Full-Verification 组件后的 **重跑**。 ### 增量同步 增量同步任务开始后，会同步源库发生变化的数据（新增、修改或删除）至目标端数据库对应的表中。当源库不断有业务写入时，OMS 会在全量数据迁移启动前，启动增量拉取模块，以拉取源实例中的增量更新数据，对其进行解析、封装，并存储至 OMS 中。 当全量数据迁移完成后，OMS 会启动增量数据回放模块，从增量数据拉取模块中获取增量数据。增量数据经过过滤、映射和转换后，再同步至目标实例中。如果您在源端执行 DDL 后，造成 Incr-Sync 异常，从而造成数据迁移项目运行失败，页面会展示造成项目失败的 DDL 语句以及跳过操作按钮。此时，您可以单击弹出框中的 **跳过**，并进行二次确认。 #### 注意 本操作可能造成源端和目标端数据结构不一致，请谨慎操作。 对于 **运行中** 状态的数据迁移项目，您可以在增量同步区域查看其延迟时间、当前位点时间，以及增量同步性能信息。延迟时间的显示逻辑为：X 秒（Y 秒前更新），Y 小于 20 秒属于正常情况。 对于 **已暂停** 或 **失败** 状态的数据迁移项目，您可以开启 DDL/DML 统计功能，统计开启该功能时间点之后的数据库操作。同时，您可以查看增量同步对象的具体信息，以及增量同步性能信息。 - **同步对象统计** 页签为您展示表级别的统计 DML 数量，在该页签上方的变更总和、Delete、Insert 和 Update 显示的数据为当前数据迁移项目中所有的 DML 数量，即 **同步对象统计** 页签统计的数量之和。 ![增量同步1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/oms/oms-enterprise/%E5%A2%9E%E9%87%8F%E5%90%8C%E6%AD%A51.png) - **增量同步性能** 页签为您展示以下内容： - 延迟：源端增量变更被同步至目标端的滞后时间，单位为秒。 - 迁移流量：源端增量变更数据被同步至目标端的流量吞吐，单位为 KB/s。 - 平均执行时间：每条 SQL 执行时间的均值，单位为 ms。 - 平均提交时间：事务提交时间的均值，单位为 ms。 - RPS：每秒处理记录数。 创建数据迁移项目时，建议您设置告警级别、告警频率等信息，以便随时掌握项目运行状态。OMS 默认低等级保护，您可以根据业务需求，修改告警等级。详情请参见 [告警设置](https://www.oceanbase.com/docs/enterprise-oms-doc-cn-10000000001904422)。 - 如果数据迁移项目的增量同步延时大于配置的告警时间，增量同步步骤始终处于运行中，系统不会触发告警信息。 - 如果数据迁移项目的增量同步延时小于等于配置的告警时间，增量同步步骤的状态由运行中切换为监控中。增量同步的状态变为监控中后，延时大于配置的告警时间，也不会再切换为运行中状态。 ### 全量校验 在全量数据迁移完成，增量数据迁移至目标端并与源端基本追平后，OMS 会自动发起一轮针对源库配置的数据表和目标表的全量数据校验任务。 #### 注意 - 如果您在选择 **迁移类型** 时未配置 **结构迁移**，则全量校验时，OMS 会以源端和目标端匹配的字段进行校验，不会检查表结构是否一致。 - 全量校验期间，如果源端对表进行 `create`、`drop`、`alter` 和 `rename` 操作，可能导致全量校验退出。 增量数据同步过程中，您也可以发起自定义的数据校验。您可以在 **全量校验** 页面查看全量校验的整体状态、启动时间、结束时间、总计耗时、预估总行数、已完成迁移行数、实时流量和 RPS 等信息。 **全量校验** 页面包括 **校验对象** 和 **全量校验性能** 页签： - 在 **校验对象** 页签，您可以查看校验的进度和校验对象列表。 - 对于全部迁移对象，均可以查看指定对象的名称、对应源库和目标库、全量校验进度、结果和结果摘要。 - 支持根据源库和目标库进行筛选。 - 支持勾选 **只查看已完成对象**，查看当前时间点已完成结构迁移的对象名称等基本信息。 - 如果您需要对全部迁移对象再次进行全量校验，请单击 **再次校验** > **重启全量校验**。 - 存在校检结果不一致的表时： 如果您需要重新校验表中的全部数据，请单击 **再次校验** > **重新校验异常的表**。 如果您仅需要重新校验表中不一致的数据，请单击 **再次校验** > **仅校验不一致的表记录**。 #### 注意 如果源端为空，则不支持订正操作。 - 在 **全量校验性能** 页签，您可以图形化查看 **源端 RPS**、**目标端 RPS**、**源端校验流量** 和 **目标端校验流量**，以及性能基准等性能数据，帮助您有效识别性能相关问题。 OMS 支持校验中或校验失败的项目跳过全量校验。在 **全量校验** 页面，单击右上角的 **跳过全量校验**，并在弹出对话框中，单击 **确定**。 #### 注意 跳过全量校验后，您将无法恢复该校验任务进行数据比对和数据订正，您需要通过克隆当前项目再次发起全量校验，请谨慎操作。 全量校验完成后，您可以单击 **进入下一阶段**，启动正向切换。进入切换流程后，您将无法复检当前校验任务进行数据比对和数据订正。 ### 正向切换 正向切换（传统意义上的系统割接流程的抽象化、标准化）不会操作业务应用连接的切换，是 OMS 的数据迁移项目配合应用切换需要执行的任务流。您需要保证在应用连接切换至目标端前完成正向切换的全部流程。 正向切换是数据迁移必不可少的一个流程，通过正向切换，OMS 可以确保完成了数据正向迁移的相关工作，并且您可以根据业务需求启动反向增量组件。正向切换主要涉及的工作如下： 1. 您需要自行确认已完成数据迁移，并等待正向同步延迟被追平。 2. OMS 将会自动补充目标端为 Oracle 数据库、OceanBase 数据库 Oracle 租户和 DB2 LUW 数据库时，结构迁移阶段忽略的检查类约束、外键约束等对象。 3. OMS 将会自动删除迁移依赖的附加隐藏列及唯一索引。 该操作仅在 Oracle 数据库和 OceanBase 数据库之间，以及 OceanBase 数据库之间的数据迁移项目存在，详情请参见 [数据迁移服务隐藏列机制说明](https://www.oceanbase.com/docs/enterprise-oms-doc-cn-10000000001904438)。 4. 您需要自行补充迁移源端触发器、函数、存储过程等其它 OMS 不支持的数据库对象至目标端。 5. 您需要自行禁用源端的触发器和外键约束（仅数据迁移项目存在反向增量时需要）。 正向切换的步骤如下： ![forward-switchover](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/oms/oms-enterprise/forward-switchover.png) 1. **启动正向切换** 该步骤为确认开始正向操作，实际后台不会执行任何相关的操作。如果您已确认完成数据迁移，需要进行业务割接，请单击 **启动正向切换**，开始 OMS 正向切换流程。 #### 注意 启动正向切换前，请确保源端为已经停写状态。 2. **切换预检查** 该步骤为正向切换之前的预检查，主要检查以下内容： - 源端和目标端延迟检查。如果延迟在 15 秒以内，则检查通过。 - 源端-账号写权限检查。如果数据迁移项目涉及反向增量，则需要额外检查源端配置的账号是否具备写数据的权限，确保反向增量可以正常写入数据。 - 目标端-账号增量读权限检查。如果数据迁移项目涉及反向增量，则需要额外检查目标端配置的账号是否具备读取数据的权限，确保反向增量可以正常从目标端读取数据。 - 目标端-增量日志检查。如果数据迁移项目涉及反向增量，则需要额外检查目标端增量日志配置是否满足反向增量日志抽取要求。 如果切换预检查通过，OMS 将自动执行下一步操作。如果切换预检查未通过，OMS 提供 **重试** 和 **跳过** 操作。 #### 注意 如果您选择跳过，可能会造成目标端数据缺失或反向增量失败等问题，请谨慎操作。 3. **启动目标端 Store** #### 说明 该步骤仅在数据迁移项目存在反向增量阶段时显示。 如果正向切换预检查通过，OMS 将自动为目标端启动增量日志拉取服务，以获取目标端的 DML、DDL 等操作、解析并保存相关的日志数据，为反向增量阶段进行准备。该步骤预计持续 3～5 分钟左右。 4. **确认源端停写** 该步骤为确认源端无持续业务写入。如果您确认源端无新增数据，请单击 **确定**，进入下一步流程。 5. **确认同步追平停写位点** 该步骤将检查目标端的同步位点是否已经追平至确认源端停写时的位点。如果未追平，OMS 将持续检查至同步位点追平为止，以确认目标端数据已全部更新完成。 6. **停止正向同步** 该步骤将停止正向同步服务。停止服务后，该项目中源端产生的任何数据库变更将不再同步至目标端。如果停止服务失败，OMS 提供 **重试** 或 **跳过** 操作。 #### 注意 跳过操作仅适用于确认正向同步服务后台已经完成处理时操作，否则可能出现源端数据非预期写入目标端的问题，请谨慎操作。 7. **执行数据库对象处理** 该步骤为处理数据迁移阶段忽略或者 OMS 暂无支持的对象，以确认业务割接切换至目标端后可以正常工作。 - 迁移数据库对象至目标端：该操作需要您自行迁移源端触发器、函数、存储过程等其它 OMS 不支持的数据库对象至目标端。如果您确认已自行完成迁移，请单击 **标记完成**。 - 禁用源端触发器外键约束：该操作仅在数据迁移项目中存在反向增量阶段时需要，用于确认反向增量时数据不会受触发器或外键约束影响，导致反向增量同步失败。该操作需要您自行完成，如果您确认已自行完成，请单击 **标记完成**。 - 补充结构迁移忽略的对象至目标端：该操作仅在目标端为 Oracle 数据库、OceanBase 数据库 Oracle 租户和 DB2 LUW 数据库时存在，用于在目标端自动补充结构迁移阶段忽略的检查类约束、外键约束等对象。其它目标端结构迁移默认迁移上述对象，无需额外操作。 - 删除 OMS 附加隐藏列和唯一索引：该操作仅在 Oracle 数据库和 OceanBase 数据库之间，以及 OceanBase 数据库之间的数据迁移项目存在，用于自动删除 OMS 为保证数据迁移一致性在目标端附加的隐藏列及唯一索引。该操作会自动运行，执行时间受目标端数据量影响。OMS 在该步骤运行时提供 **跳过** 操作，但跳过后，您需要自行删除，请谨慎操作。详情请参见 [数据迁移服务隐藏列机制说明](https://www.oceanbase.com/docs/enterprise-oms-doc-cn-10000000001904438)。 8. **启动反向增量** 该步骤为启动目标端的增量同步服务，用于将目标端的增量 DML 或 DDL 变更实时同步至源端。增量同步的配置和项目创建时的配置保持一致，其中增量 DDL 功能请参见具体数据库的 [增量 DDL 说明文档](https://www.oceanbase.com/docs/enterprise-oms-doc-cn-10000000001903127)。 ### 反向增量 对于 **运行中** 状态的数据迁移项目，您可以在反向增量区域查看其延迟时间、当前位点时间，以及反向增量性能信息。延迟时间的显示逻辑为：X 秒（Y 秒前更新），Y 小于 20 秒属于正常情况。 对于 **已暂停** 或 **失败** 状态的数据迁移项目，您可以开启 DDL/DML 统计功能，统计开启该功能时间点之后的数据库操作。同时，您可以查看反向增量同步对象的具体信息，以及反向增量性能信息。 - **同步对象统计** 页签为您展示表级别的统计 DML 数量，在该页签上方的变更总和、Delete、Insert 和 Update 显示的数据为当前数据迁移项目中所有的 DML 数量，即**同步对象统计** 页签统计的数量之和。 - **反向增量性能** 页签为您展示以下内容： - 延迟：目标端增量变更被同步至源端的滞后时间，单位为秒。 - 迁移流量：目标端增量变更数据被同步至源端的流量吞吐，单位为 KB/s。 - 平均执行时间：每条 SQL 执行时间的均值，单位为 ms。 - 平均提交时间：事务提交时间的均值，单位为 ms。 - RPS：每秒写入目标端的行数。 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线