影子表同步

影子表同步

更新时间：2026-04-13 14:45:56

背景信息

ODC 的影子表同步功能支持根据源表的表结构自动在当前库中创建影子表（表名是在源表名上增加前缀或后缀的方式生成），适用于全链路压测等场景。

本文档旨在介绍如何在 OceanBase 开发者中心（OceanBase Developer Center，ODC）上新建影子表同步。

说明

ODC V4.0.0 版本的影子表同步功能仅支持 MySQL 模式，且如果源表中包含二级分区，仅支持 HASH/KEY 的二级模板分区。

影子表创建完成后，可以在表对象列表中查看创建的影子表。

创建影子表时，如果表名已存在但表结构不同，则会生成同步 SQL 语句，更新影子表结构。

在 新建影子表同步 面板中指定以下信息。

选择对象。

影子表同步-新建1

信息项	说明
所属库	选择创建影子表的所属库并可查看当前连接名。
同步范围	选择需要同步的表：部分表：选定的表在当前库中创建影子表。全部表：来源库中所有的表都会在当前库中创建影子表。
影子表名	支持以" 前缀 +源表名"或"源表名+ 后缀 "的格式创建影子表名，并且支持自定义前、后缀。
同步对象	同步部分表时，需在同步对象中选择源表以同步为影子表。

同步影子表结构分析。

影子表同步-新建2

信息项	说明
同步的表	同步的表页签中，显示源表名、影子表名和分析结果，单击查看支持查看源表结构、影子表结构和结构变更 SQL 语句，单击跳过支持不同步该影子表。
不同步的表	不同步的表页签中，显示源表名、影子表名和分析结果，单击取消跳过支持同步该影子表。说明选择跳过同步的表，会显示在不同步的表页签中。如果影子表名已存在且结构与源表一致，则会自动跳过同步表结构。
SQL 预览	显示同步表结构的 SQL 语句。
任务设置	选择审批完成后的执行方式。立即同步：立即执行同步任务。定时同步：定时执行同步任务。
任务设置	选择任务错误处理方式。停止任务：在执行过程中，遇到出错则中断后面的 SQL 脚本，不再执行。忽略错误继续执行：在执行过程中，跳过当前出错的 SQL 脚本继续执行，并执行完所有 SQL 脚本。
备注	描述项目的业务背景信息，例如变更目的、预期目标等。