查看和修改同步对象及其过滤条件

背景信息

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

如果您需要修改通过匹配规则方式配置的数据同步任务的同步对象及其 SQL 过滤条件，请参见 配置匹配规则。

使用限制

• 数据同步任务处于 未启动、运行中 或 已暂停 状态时，支持增加和减少同步对象。

  重要

  对于处于 已暂停 状态的数据同步任务，如果 增量同步 步骤处于 已暂停 状态，则不支持增加同步对象。

• 数据同步任务处于 失败 状态时，不支持增加同步对象。

• 数据同步任务处于 修改中 或 合并中 状态时，不支持再次修改同步对象。

• 数据同步任务的 增量同步 步骤处于 已暂停 或 失败 状态时，不支持增加同步对象。

• 数据同步任务处于 已暂停、失败、未启动 和 运行中 状态时，支持修改行过滤条件。

查看同步对象

1. 登录 OceanBase 管理控制台。

2. 在左侧导航栏，单击 数据传输 > 数据同步。

3. 在 数据同步 页面，单击目标任务的名称，进入该任务的详情页面。

   

4. 单击页面右上角的 查看对象，查看 同步对象 和 修改对象记录。

   • 同步对象 页签为您展示当前任务的同步对象，您还可以单击 修改对象，进行增加对象、减少对象，以及修改行过滤条件等操作。

   • 修改对象记录 页签为您展示所有修改对象操作的修改类型、状态和修改时间等信息。

增加同步对象

1. 在目标任务的详情页面，单击右上角的 查看对象。

   

2. 在 查看对象 对话框，单击 同步对象 > 增加对象。

   

3. 在 增加对象 对话框中选择需要增加的同步对象。

   重要

   • 新增对象将默认继承原数据同步任务的全部配置选项。如果增加对象的过程中终止了操作，则需要手动删除目标库中已增加的对象。

   • 如果源端数据源配置了 Schema Name 或 DB Name，则仅支持增加指定 Schema Name 或 DB Name 下的同步对象。

   • 对于目标端为消息队列的数据同步任务，在 增加对象 对话框的左侧 源端对象 区域，选中需要同步的对象，单击 >，在 将对象映射至 Topic 对话框中，选择需要的映射方式进行配置。

     

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

     

   • 对于目标端为数据库的数据同步任务，在 增加对象 对话框的左侧 源端对象 区域，选中需要同步的对象，单击 >，将其添加至右侧列表中。

     

     选择增加的同步对象后，您可以对目标端对象进行重命名、设置行过滤或移除对象等操作。

     

4. 选择完成后，单击 下一步。

5. 系统会自动对增加对象执行预检查。全部检查任务均通过后，单击 保存。

6. 确认无误后，在弹出框单击 确定。

   • 如果任务处于已暂停或失败状态，您可以取消后重新进行修改。修改后，请先恢复数据同步任务，才能执行增加对象操作。

   • 如果任务处于运行中状态，单击保存后，将立即执行增加对象操作。

   增加对象操作开始执行后，会在 查看对象 > 修改对象记录 页面生成记录，您可以进入该页面查看记录的详细信息。

   

   增加对象记录的状态包括 待执行、已取消、修改中、运行中、已终止、合并中、成功 和 失败，不同状态的增加对象记录支持的操作，以及处于运行中状态的原任务对应的状态也不同。

   说明

   原任务处于 未启动 状态时，增加对象会生成一条 成功 状态的修改记录。原任务处于 已暂停 状态时，增加对象会生成一条 待执行 状态的修改记录。

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

   增加对象记录的状态	支持的操作	原任务对应的状态

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

减少同步对象

1. 在目标任务的详情页面，单击右上角的 查看对象。

   

2. 在 查看对象 对话框，单击 同步对象 > 减少对象。

   

3. 在 减少对象 对话框的右侧 目标端对象 区域，鼠标悬停至需要减少同步的对象，单击 移除。

   

   对于目标端为消息队列的数据同步任务，您还可以勾选复选框，选择多个需要移除的对象，单击 批量移除。在弹出框中，单击 确定。

   

4. 单击 减少对象 对话框下方的 移除。

5. 在弹出框中确认需要移除的对象无误后，单击 确定。

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

   重要

   • 对象减少后不可恢复，请谨慎操作。

   • 减少对象操作最终是全部成功或全部失败。

   减少对象操作开始执行后，会在 查看对象 > 修改对象记录 页面生成记录，您可以进入该页面查看记录的详情。

   

   减少对象记录的状态包括 待执行、已取消、修改中、成功 和 失败，不同状态的修改对象记录支持的操作，以及处于运行中状态的原任务对应的状态也不同。

   减少对象记录的状态	支持的操作	原任务对应的状态

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

修改同步对象的过滤条件

本节为您介绍通过指定对象方式选择的同步对象，在数据同步任务运行过程中，如何修改 SQL 条件来过滤数据。

1. 在目标任务的详情页面，单击右上角的 查看对象。

   

2. 在 查看对象 > 同步对象 页面，展开目标 Schema，将鼠标悬停至目标对象，单击显示的 设置。

   

3. 在 设置 > 行过滤条件 文本框中，输入标准的 SQL 语句中的 WHERE 子句，来配置或修改行过滤。详情请参见 SQL 条件过滤数据。

   

4. 配置完成后，单击 验证语法。

5. 通过验证后，在 设置 对话框中，单击 确定。

6. 确认修改的设置需要应用至对象后，在弹出的对话框中，单击 应用。

7. 在 修改记录 页面，查看修改过滤条件的进度。

   

   您也可以单击修改设置记录后的 查看详情，在 修改设置详情 页面，将鼠标悬停至目标数据表，单击显示的 查看设置，查看修改后的行过滤条件。