---
title: "查看数据迁移任务的详情 | OceanBase 文档中心"
description: 查看数据迁移任务的详情 启动数据迁移任务后，您可以在数据迁移任务的详情页面查看相应任务的基本信息、任务执行的进度和状态等信息。 进入详情页面 登录 OMS 控制台。 在左侧导航栏，单击 数据迁移 。 在 数据迁移 页面，单击目标任务的名称，进入详情页面查看其 基本信息 和 迁移详情 。 您可以在 数据迁移 页面，根据…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*L03BS6f-o40AAAAAAAAAAAAADiGDAQ/original) 迁移服务 OMSV 4.3.1 企业版

# 查看数据迁移任务的详情

更新时间：2026-04-14 15:36:02

启动数据迁移任务后，您可以在数据迁移任务的详情页面查看相应任务的基本信息、任务执行的进度和状态等信息。

## 进入详情页面

1. 登录 OMS 控制台。
 2. 在左侧导航栏，单击 **数据迁移**。
 3. 在 **数据迁移** 页面，单击目标任务的名称，进入详情页面查看其 **基本信息** 和 **迁移详情**。

   您可以在 **数据迁移** 页面，根据标签、状态、类型和关键字等，搜索目标数据迁移任务。数据迁移任务的状态包括：

      - **未启动**：表示数据迁移任务尚未启动，您可以在对应的操作列中单击 **启动**。
      - **运行中**：数据迁移任务运行中，状态右侧展示了数据迁移的计划和当前进度。
      - **修改中**：数据迁移任务正在被修改迁移对象。
      - **合并中**：被修改迁移对象的数据迁移任务与修改迁移对象任务进行合并的过程。
      - **已暂停**：数据迁移任务已被手动中止，您可以在对应的操作列中单击 **恢复**，从中止的子任务开始继续执行迁移。
      - **失败**：数据迁移任务执行失败，状态右侧展示该任务失败的具体环节。单击数据迁移任务的名称，您可以在详情页面查看具体的报错信息。
      - **已完成**：数据迁移任务已成功执行完毕，OMS 已按照您预设的迁移模式将指定的数据内容迁移至目标库中。
      - **释放中**：数据迁移任务正在被释放。释放中的数据迁移任务不能进行任何操作。
      - **已释放**：数据迁移任务已经成功释放。释放后，OMS 会终止当前的迁移和增量同步任务。

## 查看基本信息

**基本信息** 区域为您展示当前数据迁移任务相关的基本信息。

| **参数** | **描述** |
| --- | --- |
| ID | 数据迁移任务的唯一 ID 标识。 |
| 迁移类型 | 创建数据迁移任务时，选择的迁移类型。 |
| 告警等级 | 显示当前任务的告警等级。OMS 支持的告警级别包括 **无保护**、**高保护**、**中保护** 和 **低保护**，设置的详情请参见 [告警设置](https://www.oceanbase.com/docs/enterprise-oms-doc-cn-1000000004023129)。 |
| 创建人 | 当前数据迁移任务的创建人。 |
| 创建时间 | 当前数据迁移任务的创建时间。 |
| 连接详情 | 单击 **连接详情**，查看数据迁移任务源端和目标端的连接信息。 |

您可以进行以下操作：

- 配置校验任务

  单击页面右上角的 **配置校验任务**，您可以引用当前迁移任务的源端、目标端、迁移对象，快速发起数据校验。详情请参见 [新建数据校验任务](https://www.oceanbase.com/docs/enterprise-oms-doc-cn-1000000004023087)。
 - 查看迁移对象

  单击页面右上角的 **查看对象**，查看当前数据迁移任务的迁移对象列表。您还可以在数据迁移任务运行过程中修改迁移对象。详情请参见 [查看和修改迁移对象](https://www.oceanbase.com/docs/enterprise-oms-doc-cn-1000000004023142)。
 - 查看组件监控

  单击页面右上角的 **查看组件监控**，查看 Store、Incr-Sync、Full-Import 和 Full-Verification 等组件的信息。您还可以对各组件进行以下操作：

     - 启动组件：单击未运行的目标组件后的 **启动**，在对话框中，单击 **确定**。
     - 暂停组件：单击运行中的目标组件后的 **暂停**，在对话框中，单击 **确定**。
     - 更新组件：单击目标组件后的 **更新**，在 **更新配置** 页面，修改相应配置后，单击 **更新**。

      #### 注意

      此处的更新包含重启操作，请谨慎操作。
     - 查看日志：单击目标组件后的 **查看日志**， **查看日志** 页面为您展示最近的相关运行中产生的日志。您可以进行 **查找**、**下载** 和 **复制**。
 - 查看或修改参数配置

  处于 **运行中**、**修改中**、**合并中**、**已完成**、**结束中** 和 **已结束** 状态的数据迁移任务，支持查看参数配置。处于 **未启动**、**已暂停** 和 **失败** 状态的数据迁移任务，支持修改参数配置。详情请参见 [查看和修改迁移参数配置](https://www.oceanbase.com/docs/enterprise-oms-doc-cn-1000000004023140)。

  此处支持修改的具体参数和数据迁移任务的类型，以及任务运行的阶段有关，不同的运行阶段支持修改的参数不同。
 - 下载对象配置信息

  OMS 支持下载数据迁移任务的配置信息，以批量导入的格式输出。详情请参见 [下载和导入迁移对象配置](https://www.oceanbase.com/docs/enterprise-oms-doc-cn-1000000004023133)。
 - 下载冲突日志文件

  在数据迁移任务的全量迁移、增量同步或反向增量步骤，如果存在冲突数据，OMS 支持下载冲突日志文件。详情请参见 [下载冲突日志文件](https://www.oceanbase.com/docs/enterprise-oms-doc-cn-1000000004023135)。

## 查看迁移详情

**迁移详情** 区域为您展示当前任务中，所有环节子任务的执行状态、进度、启动时间、完成时间和总计耗时等信息。

### 结构迁移

负责迁移源库中的数据对象定义（表、索引、约束、注释和视图等）至目标库中，会自动过滤临时表。当源端数据库非 OceanBase 数据库时，会依据目标 OceanBase 租户类型的语法定义标准进行数据类型和 SQL 语法的自动转换和拼装，然后复制至目标库中。当目标端已存在同名的迁移对象时，OMS 将采取默认跳过的逻辑，您需要自行确保源端和目标端表结构的一致性。

如果您在运行数据迁移任务时，进入了正向切换步骤，OMS 会根据数据迁移任务的类型，自动删除隐藏列和唯一索引。详情请参见 [数据迁移服务隐藏列机制说明](https://www.oceanbase.com/docs/enterprise-oms-doc-cn-1000000004023213)。

您可以在 **结构迁移** 页面，查看结构迁移的整体状态、启动时间、结束时间、总计耗时，以及目标对象的迁移进度。对于 Oracle 数据库至 OceanBase 数据库 Oracle 兼容模式的数据迁移任务，您还可以在进度右侧，查看和修改完成结构迁移后是否进入下一阶段。

同时，您可以对目标对象进行以下操作：

- 查看创建语法：在 **库** 或 **表** 页签下，单击目标对象后的 **查看**，即可查看库、表或索引的创建语法。

  如果表创建语法完全兼容，为您展示在 OBServer 节点执行的 DDL 语法。不完全兼容，则展示转换后的创建语法。
 - 修改创建语法并重试：运行失败的 DDL 和报错，您可以检查并修改该条 DDL 转换结果的定义，再次迁移至目标端。
 - 重试/重试全部失败对象：失败的结构迁移任务，您可以依次进行重试，也可以单击页签右上角的 **重试全部失败对象**。
 - 跳过/批量跳过：失败的结构迁移任务，您可以依次跳过。您也可以批量选择需要跳过的对象，单击右上角的 **批量跳过**。跳过对象时，索引会一并跳过。
 - 移除/批量移除：失败的结构迁移任务，您可以依次进行移除。您也可以批量选择需要移除的对象，单击右上角的 **批量移除**。移除对象时，索引会一并移除。
 - 查看详情：失败的结构迁移任务，展示 DDL 语句和 OBServer 节点上执行的错误信息。
 - 结构迁移完成后，对于状态为 **已完成（有转换）** 的表，您可以下载部分或全部结构转换信息的 CSV 文件。

     1. 单击页签右上角的 **...** > **下载结构转换信息**。
     2. 在 **下载结构转换信息** 对话框，选择下载对象为 **仅转换信息** 或 **目标端完整 DDL 及转换信息**。

       ![oms86-zh](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/oms/oms-enterprise/oms86-zh.png)
     3. 单击 **下载**。

### 全量迁移

迁移源库表的存量数据至目标库对应的表中。您可以在 **全量迁移** 页面，根据源库和目标库进行筛选，或勾选 **查看有问题的对象**，筛选阻碍整体迁移进度的对象。您还可以查看 **表对象**、**表索引** 和 **全量迁移性能**。只有表对象和表索引均迁移完成，全量迁移的状态才会显示已完成。

- 在 **表对象** 页签，您可以查看对象名称、源库、目标库、预估数据量、已完成数据量和对应的状态。
 - 在 **表索引** 页签，您可以查看表对象、源库、目标库、创建时间、结束时间、耗时及其对应的状态。同时，您可以查看索引的创建语法，并移除无需使用的索引。
 - 在 **全量迁移性能** 页签，您可以图形化查看 **源端 RPS**、**目标端 RPS**、**源端迁移流量**、**目标端迁移流量**、**源端平均读取时间**、**源端平均切片时间** 和 **目标端平均写入时间**，帮助您有效识别性能相关问题。

全量迁移加上增量同步，可以确保目标端数据库与源端数据库的最终一致性。如果全量迁移过程中有失败的对象，会为您展示具体的失败原因。

#### 注意

- 如果您在选择 **迁移类型** 时未配置 **结构迁移**，则全量迁移时，OMS 会以源端和目标端匹配的字段进行迁移，不会检查表结构是否一致。
 - 在全量迁移完成之后，且后续步骤已启动的情况下，不允许在 **运维监控** > **组件** > **Full-Verification** 页面，单击目标 Full-Verification 组件后的 **重跑**。

### 增量同步

增量同步任务开始后，会同步源库发生变化的数据（新增、修改或删除）至目标端数据库对应的表中。当源库不断有业务写入时，OMS 会在全量数据迁移启动前，启动增量拉取模块，以拉取源实例中的增量更新数据，对其进行解析、封装，并存储至 OMS 中。

当全量数据迁移完成后，OMS 会启动增量数据回放模块，从增量数据拉取模块中获取增量数据。增量数据经过过滤、映射和转换后，再同步至目标实例中。如果您在源端执行 DDL 后，造成 Incr-Sync 异常，从而造成数据迁移任务运行失败，页面会展示造成任务失败的 DDL 语句以及跳过操作按钮。此时，您可以单击弹出框中的 **跳过**，并进行二次确认。

#### 注意

本操作可能造成源端和目标端数据结构不一致，请谨慎操作。

对于 **运行中** 状态的数据迁移任务，您可以在增量同步区域查看其延迟时间、当前位点时间或消费 Kafka 位点时间，以及增量同步性能信息。通常延迟时间的显示逻辑为：X 秒（Y 秒前更新），Y 小于 20 秒属于正常情况。

如果 Oracle 数据源配置了 **通过 Kafka 获取增量数据**，Oracle 数据库至 OceanBase 数据库 Oracle 兼容模式的增量同步和 OceanBase 数据库 Oracle 兼容模式至 Oracle 数据库的反向增量的延迟时间显示逻辑为：Kafka 消息 X 秒/增量数据 Y。

- Kafka 消息延迟指增量同步读取 Kafka 并写入目标端时，该数据写入 Kafka 时的时间戳与当前时间对比产生的延迟。
 - 增量数据延迟指增量同步读取 Kafka 并写入目标端时，该数据在源端产生数据时的时间戳与当前时间对比产生的延迟。请注意由于 OGG 投递至 Kafka 消息不保序，该延迟时间仅供参考。

对于 **已暂停** 或 **失败** 状态的数据迁移任务，您可以开启 DDL/DML 统计功能，统计开启该功能时间点之后的数据库操作。同时，您可以查看增量同步对象的具体信息，以及增量同步性能信息。

- **同步对象统计** 页签为您展示表级别的统计 DML 数量，在该页签上方的变更总和、Delete、Insert 和 Update 显示的数据为当前数据迁移任务中所有的 DML 数量，即 **同步对象统计** 页签统计的数量之和。

  ![migration-77-zh](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/oms/oms-enterprise/migration-77-zh.png)
 - **增量同步性能** 页签为您展示以下内容：

     - 延迟：源端增量变更被同步至目标端的滞后时间，单位为秒。
     - 迁移流量：源端增量变更数据被同步至目标端的流量吞吐，单位为 KB/s。
     - 平均执行时间：每条 SQL 执行时间的均值，单位为 ms。
     - 平均提交时间：事务提交时间的均值，单位为 ms。
     - RPS：每秒写入目标端的行数。

  创建数据迁移任务时，建议您设置告警级别、告警频率等信息，以便随时掌握任务运行状态。OMS 默认低等级保护，您可以根据业务需求，修改告警等级。详情请参见 [告警设置](https://www.oceanbase.com/docs/enterprise-oms-doc-cn-1000000004023129)。

     - 如果数据迁移任务的增量同步延时大于配置的告警时间，增量同步步骤始终处于运行中，系统不会触发告警信息。
     - 如果数据迁移任务的增量同步延时小于等于配置的告警时间，增量同步步骤的状态由运行中切换为监控中。增量同步的状态变为监控中后，延时大于配置的告警时间，也不会再切换为运行中状态。

### 正向切换

正向切换（传统意义上的系统割接流程的抽象化、标准化）不会操作业务应用连接的切换，是 OMS 的数据迁移任务配合应用切换需要执行的任务流。您需要保证在应用连接切换至目标端前完成正向切换的全部流程。

正向切换是数据迁移必不可少的一个流程，通过正向切换，OMS 可以确保完成了数据正向迁移的相关工作，并且您可以根据业务需求启动反向增量组件。正向切换主要涉及的工作如下：

1. 您需要自行确认已完成数据迁移，并等待正向同步延迟被追平。
 2. OMS 将会自动补充目标端为 Oracle 数据库、OceanBase 数据库 Oracle 兼容模式和 DB2 LUW 数据库时，结构迁移阶段忽略的检查类约束、外键约束等对象。
 3. OMS 将会自动删除迁移依赖的附加隐藏列及唯一索引。

   该操作仅在 Oracle 数据库和 OceanBase 数据库之间，以及 OceanBase 数据库之间的数据迁移任务存在，详情请参见 [数据迁移服务隐藏列机制说明](https://www.oceanbase.com/docs/enterprise-oms-doc-cn-1000000004023213)。
 4. 您需要自行补充迁移源端触发器、函数、存储过程等其它 OMS 不支持的数据库对象至目标端。
 5. 数据迁移任务存在反向增量时，您需要自行禁用源端的触发器，以及删除外键约束。

正向切换的步骤如下：

![forward-switchover-zh](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/oms/oms-enterprise/forward-switchover-zh.png)

1. **启动正向切换**

   该步骤为确认开始正向操作，实际后台不会执行任何相关的操作。如果您已确认完成数据迁移，需要进行业务割接，请单击 **启动正向切换**，开始 OMS 正向切换流程。

   #### 注意

   启动正向切换前，请确保源端为已经停写状态。
 2. **切换预检查**

   该步骤为正向切换之前的预检查，主要检查以下内容：

      - 源端和目标端延迟检查。如果延迟在 15 秒以内，则检查通过。
      - 源端-账号写权限检查。如果数据迁移任务涉及反向增量，则需要额外检查源端配置的账号是否具备写数据的权限，确保反向增量可以正常写入数据。
      - 目标端-账号增量读权限检查。如果数据迁移任务涉及反向增量，则需要额外检查目标端配置的账号是否具备读取数据的权限，确保反向增量可以正常从目标端读取数据。
      - 目标端-增量日志检查。如果数据迁移任务涉及反向增量，则需要额外检查目标端增量日志配置是否满足反向增量日志抽取要求。

   如果切换预检查通过，OMS 将自动执行下一步操作。如果切换预检查未通过，OMS 提供 **重试** 和 **跳过** 操作。

   #### 注意

   如果您选择跳过，可能会造成目标端数据缺失或反向增量失败等问题，请谨慎操作。
 3. **启动目标端 Store**

   #### 说明

      - 该步骤仅在数据迁移任务存在反向增量阶段时显示。
      - 如果 Oracle 数据源配置了 **通过 Kafka 获取增量数据**，OceanBase 数据库 Oracle 兼容模式至 Oracle 数据库数据迁移任务的反向增量场景，无需启动目标端 Store。  

   如果正向切换预检查通过，OMS 将自动为目标端启动增量日志拉取服务，以获取目标端的 DML、DDL 等操作、解析并保存相关的日志数据，为反向增量阶段进行准备。该步骤预计持续 3～5 分钟左右。
 4. **确认源端停写**

   该步骤为确认源端无持续业务写入。如果您确认源端无新增数据，请单击 **确定**，进入下一步流程。
 5. **确认同步追平停写位点**

   该步骤将检查目标端的同步位点是否已经追平至确认源端停写时的位点。如果该步骤处于运行中或失败状态，长时间未追平位点，您可以单击 **跳过**。

   #### 注意

   如果您选择跳过，可能导致源端和目标端的数据不一致，请谨慎操作。
 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-1000000004023213)。
 8. **启动反向增量**

   #### 说明

   该步骤仅在数据迁移任务存在反向增量阶段时显示。

   该步骤为启动目标端的增量同步服务，用于将目标端的增量 DML 或 DDL 变更实时同步至源端。增量同步的配置和任务创建时的配置保持一致，其中增量 DDL 功能请参见具体数据库的 [增量 DDL 说明文档](https://www.oceanbase.com/docs/enterprise-oms-doc-cn-1000000004023148)。

### 反向增量

对于 **运行中** 状态的数据迁移任务，您可以在反向增量区域查看其延迟时间、当前位点时间，以及反向增量性能信息。延迟时间的显示逻辑为：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) 咨询热线
