查看和修改迁移对象及其过滤条件

背景信息

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

使用限制

• 仅通过 指定对象 方式选择迁移对象的数据迁移任务，支持修改迁移对象。

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

  重要

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

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

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

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

• 数据迁移任务处于 反向增量 步骤时，不支持增加迁移对象。

• 迁移 Lindorm 或 HBase 数据库的数据至 OBKV 时，不支持增加迁移对象，以及修改行过滤条件。

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

查看迁移对象

1. 登录 OceanBase 管理控制台。

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

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

   

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

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

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

增加迁移对象

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

   

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

   

3. 在 增加对象 对话框的左侧 源端对象 区域，选中需要迁移的对象，单击 >，将其添加至右侧列表中。您可以选择一个或多个库的表、视图作为迁移对象。

   

   选择增加的迁移对象后，您可以进行重命名对象名称、设置行过滤、查看列信息和移除对象等操作。

   

   重要

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

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

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

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

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

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

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

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

   

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

   说明

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

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

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

减少迁移对象

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

   

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

   

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

4. 在 减少对象 对话框，单击 移除。

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

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

   重要

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

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

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

   

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

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

修改迁移对象的过滤条件

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

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

   

2. 在 查看对象 > 迁移范围 页面，展开目标数据库，将鼠标悬停至目标对象，单击显示的 设置。

   

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

   

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

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

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

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

   

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