---
title: "查看和修改同步对象 | OceanBase 文档中心"
description: 查看和修改同步对象 本文为您介绍如何在 OceanBase 迁移服务（OceanBase Migration Service，OMS）社区版中查看和修改已配置的数据同步项目的同步对象。 背景信息 数据同步项目在同步过程中，满足限制条件的情况下，您可以增加或减少同步对象。每一次运行的修改行为都会被记录。当增加对象任务执…
---
切换语言

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

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

# 查看和修改同步对象

更新时间：2026-04-14 15:40:46

[编辑](https://github.com/oceanbase/oms-doc/edit/V4.0.0/zh-CN/700.data-synchronization/1100.manage-a-data-synchronization-projects/200.view-and-modify-objects-to-be-synchronized.md)  

本文为您介绍如何在 OceanBase 迁移服务（OceanBase Migration Service，OMS）社区版中查看和修改已配置的数据同步项目的同步对象。

## 背景信息

数据同步项目在同步过程中，满足限制条件的情况下，您可以增加或减少同步对象。每一次运行的修改行为都会被记录。当增加对象任务执行完成后，会与关联的原项目合并。合并成功后，原项目正常运行，增加对象任务会自动释放。

## 使用限制

- 数据同步项目处于 **未启动**、**运行中** 或 **已暂停** 状态时，支持增加和减少同步对象。
 - 数据同步项目处于 **失败** 状态时，仅支持减少同步对象。
 - 数据同步项目处于 **修改中** 或 **合并中** 状态时，不支持再次修改同步对象。
 - 数据同步项目的 **增量同步** 步骤处于 **暂停** 或 **失败** 状态时，仅支持减少同步对象。
 - 同步 IDB 逻辑表的数据至 OceanBase 数据库 MySQL 租户和 DataHub 时，仅支持增加同步对象。

## 查看同步对象

1. 登录 OMS 社区版控制台。
 2. 在左侧导航栏，单击 **数据同步**。
 3. 在 **数据同步** 页面，单击目标项目的名称，进入该项目的详情页面。
 4. 单击页面右上角的 **查看对象**，查看 **同步对象** 和 **修改对象记录**。

      - **同步对象** 页签为您展示当前项目的同步对象，您还可以单击 **修改对象**，进行 **增加对象** 和 **减少对象** 操作。
      - **修改对象记录** 页签为您展示所有修改对象操作的 ID、修改类型、状态和修改时间等信息。

## 增加同步对象

1. 在目标项目的详情页面，单击右上角的 **查看对象**。
 2. 在 **查看对象** 对话框，单击 **修改对象** > **增加对象**。
 3. 在 **增加对象** 对话框，在选择区域左侧选中需要同步的对象，单击 **>**，在 **将对象映射至 Topic** 对话框中，选择需要的映射方式进行配置。

   选择增加的同步对象后，您可以进行更改 Topic、设置行过滤等操作。

   > **注意：**
   >
   >  
   >
   > 新增对象将默认继承原数据同步项目的全部配置选项。如果增加对象的过程中终止了操作，您需要手动删除目标库中已增加的对象。
 4. 选择完成后，单击 **下一步**。
 5. 系统会自动对增加对象执行预检查。全部检查项目均通过后，单击 **保存**。
 6. 确认无误后，在弹出框单击 **确定**。

      - 如果项目处于已暂停或失败状态，您可以取消后重新进行修改。修改后，请先恢复数据同步项目，才能够执行增加对象操作。
      - 如果项目处于运行中状态，单击保存后，将立即执行增加对象操作。

   增加对象操作开始执行后，会在 **查看对象** > **修改对象记录** 页面生成记录，您可以进入该页面查看记录的详情。增加对象记录的状态包括 **待执行**、**已取消**、**修改中**、**运行中**、**已终止**、**合并中**、**成功** 和 **失败**，不同状态的增加对象记录支持的操作，以及处于运行中状态的原项目对应的状态也不同。

   > **说明：**
   >
   >  
   >
   > 原项目处于 **未启动** 状态时，增加对象会生成一条 **成功** 状态的修改记录。原项目处于 **已暂停** 状态时，增加对象会生成一条 **待执行** 状态的修改记录。

   只有原项目处于运行中的状态，增加对象记录的状态才会被推进。增加对象记录的状态推进后，原项目状态也随之更新。详情请参见下表。

   | **增加对象记录的状态** | **支持的操作** | **原项目对应的状态** |
   | --- | --- | --- |
   | 待执行 | 查看详情、取消 | 运行中 |
   | 已取消 | 无 | 运行中 |
   | 修改中 | 无 | 修改中 |
   | 运行中 | 查看详情、终止 | 修改中 |
   | 已终止 | 查看详情 | 运行中 |
   | 合并中 | 查看详情 | 合并中 |
   | 成功 | 查看详情 | 运行中 |
   | 失败 | 查看详情、重试    您还可以单击 **查看原因**，跳转至任务的详情页面，查看失败的原因。 | 修改中/合并中 |

## 减少同步对象

1. 在目标项目的详情页面，单击右上角的 **查看对象**。
 2. 在 **查看对象** 对话框，单击 **修改对象** > **减少对象**。
 3. 在 **减少对象** 对话框的右侧 **目标端对象** 区域，鼠标悬停至需要减少迁移的对象，单击 **移除**。

   您也可以勾选复选框，选择多个需要移除的对象，单击 **批量移除**，在弹出框中，单击 **确认**。
 4. 在 **减少对象** 对话框，单击 **移除**。
 5. 在弹出框中确认需要移除的对象无误后，单击 **确定**。

   如果项目处于已暂停、失败或运行中状态，单击确定后，将立即执行减少对象操作。

   > **注意：**
   >
   >  
   >    - 对象减少后不可恢复，请谨慎操作。
   >    - 减少对象操作最终是全部成功或全部失败。

   减少对象操作开始执行后，会在 **查看对象** > **修改对象记录** 页面生成记录，您可以进入该页面查看记录的详情。减少对象记录的状态包括 **待执行**、**已取消**、**修改中**、**成功** 和 **失败**，不同状态的修改对象记录支持的操作，以及处于运行中状态的原项目对应的状态也不同。

   | **减少对象记录的状态** | **支持的操作** | **原项目对应的状态** |
   | --- | --- | --- |
   | 待执行 | 查看详情、取消 | 运行中 |
   | 已取消 | 无 | 运行中 |
   | 修改中 | 无 | 修改中 |
   | 成功 | 查看详情 | 运行中 |
   | 失败 | 查看详情、重试    您还可以单击 **查看原因**，跳转至任务的详情页面，查看失败的原因。 | 修改中 |

 上一篇 下一篇 ![有帮助](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) 咨询热线