更新时间：2025-08-15 GMT+08:00
修改HTAP标准版实例表黑白名单与修复异常表
操作场景
在对TaurusDB中数据库创建了同步任务之后，您可能需要在已有任务的基础上进行以下操作：
使用须知
- 当出现重命名表异常时，不支持通过创建“修复异常表”临时任务来修复重命名后的表，需要通过“添加表”方式同步重命名后的表。
- 建议选择业务负载低峰期进行表黑白名单的变更。
- 单次可以调整的表黑白名单的表数量上限为50个，根据业务负载可以适当采用更小的表变更数量。
- 调整表黑白名单时不支持黑名单和白名单之间的相互切换。
- 修改表黑白名单时，黑名单仅支持增加表，白名单仅支持删除表。
- 一个主任务同时只能有一个临时任务，待临时任务被合并或删除后，才能继续执行添加表和修复异常表的操作。
- 添加表和修复异常表期间不支持DDL操作，否则临时任务会合并失败，需要将临时任务删除，然后重新执行添加/修复表的操作。
- 当前支持对同一个库建多个同步任务，因此在进行添加表的操作时，新添加的表不能和其他任务中的表有冲突，否则会添加失败。
操作步骤
- 登录管理控制台。
- 单击管理控制台左上角的
，选择区域和项目。 - 在页面左上角单击
，选择。 - 在“实例管理”页面的实例列表中，选择目标TaurusDB实例，单击实例名称进入实例概览页面。
- 在左侧导航栏选择“HTAP实时分析”。
- 单击目标HTAP实例名称，进入实例的“基本信息”页面。
- 在左侧导航栏单击“数据同步”，选择要修改的同步任务，单击操作栏中的“查看”按钮，进入查看界面。
图1 查看数据同步任务入口
- 进入查看界面后，单击右下角的“编辑”按钮。
图2 同步任务编辑入口
- 在表黑白名单中将需要删除的表取消勾选，并单击右下角的“编辑同步任务”按钮，然后返回同步列表，完成表删除操作。
您还可以通过在搜索框中一次性输入多张表，快速找到目标表。表之间可以通过逗号(“,”)、空格(“ ”)、换行分隔，且在多表输入之后，与库中表相匹配的表会出现在搜索结果中。
图3 同步表的删除操作
- 再次单击“查看”，确认刚才删除的表已不在同步范围内。
图4 修改后的表同步名单
- 登录管理控制台。
- 单击管理控制台左上角的，选择区域和项目。
- 在页面左上角单击，选择。
- 在“实例管理”页面的实例列表中，选择目标TaurusDB实例，单击实例名称进入实例概览页面。
- 在左侧导航栏选择“HTAP实时分析”。
- 单击目标HTAP实例名称，进入实例的“基本信息”页面。
- 在左侧导航栏单击“数据同步”，选择需要添加表的任务，单击其操作列的“更多 > 添加表”，进入添加表页面。
- 选择需要添加的表，根据需要进行表同步设置，单击“确定”。
如果勾选了已经被同步的表，会根据最新的表同步设置规则重新对该表进行同步。
不能添加其他任务中已经在同步的表。
图5 选择添加的表及对应的表同步设置
- 返回“数据同步”，单击新增的临时任务操作列的“同步”按钮。
图6 同步临时任务
- 等待临时任务从列表消失后，说明表已经完成同步并成功添加至原来的任务中。此时可以单击原主任务操作列中的“查看”，检查表是否被添加成功。
图7 表已经被成功添加至主任务
- 登录管理控制台。
- 单击管理控制台左上角的，选择区域和项目。
- 在页面左上角单击，选择。
- 在“实例管理”页面的实例列表中，选择目标TaurusDB实例，单击实例名称进入实例概览页面。
- 在左侧导航栏选择“HTAP实时分析”。
- 单击目标HTAP实例名称，进入实例的“基本信息”页面。
- 在左侧导航栏单击“数据同步”，查看任务信息，发现该任务下有表的同步出现了异常，此时可以开始进行修复表的操作。
图8 发现有异常表t1
- 返回“数据同步”，单击异常任务操作列中的“更多 > 修复异常表”。
图9 修复异常表
- 进入“修复异常表”页面，选中需要修复的表，根据需要进行表同步设置的操作，单击“确定”。
图10 选择需要修复的异常表
- 返回“数据同步”，开始同步新出现的临时任务。单击操作列的“同步”，等待该临时任务同步数据，待异常表数据恢复后，会自动合并到原来的主任务中。
图11 同步新出现的临时任务
- 待临时任务消失后，说明异常表已被修复，此时可以查看主任务信息，发现异常表已消失。
图12 异常表已被修复
