---
title: "影子表同步 - 开发者中心 ODC V4.4.2 | OceanBase 文档中心"
description: 影子表同步 背景信息 ODC 的影子表同步功能支持根据源表的表结构自动在当前库中创建影子表（表名是在源表名上增加前缀或后缀的方式生成），适用于全链路压测等场景。 本文档以创建影子表为例，介绍如何在数据库 odc_test 中创建影子表 employee_t。 说明 文中所使用的均为示例数据，您可根据实际情况对数据进行…
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*lqS5SYzz_YEAAAAAAAAAAAAADiGDAQ/original) 开发者中心 ODCV 4.4.2

# 影子表同步

更新时间：2026-04-07 10:55:47

[编辑](https://github.com/oceanbase/odc-doc/edit/V4.4.2/zh-CN/700.tickets-management/800.shadow-table-synchronization.md)  

## 背景信息

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

本文档以创建影子表为例，介绍如何在数据库 odc_test 中创建影子表 employee_t。

#### 说明

- 文中所使用的均为示例数据，您可根据实际情况对数据进行替换。
 - ODC V4.0.0 及之后版本的影子表同步功能仅支持 MySQL 模式，且如果源表中包含二级分区，仅支持 HASH/KEY 的二级模板分区。
 - 影子表创建完成后，可以在表对象列表中查看创建的影子表。
 - 创建影子表时，如果表名已存在但表结构不同，则会生成同步 SQL 语句，更新影子表结构。

## 新建影子表同步

1. 在 **项目** > **全部项目** 页面中单击目标项目名称。

   ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/441/700.database-change-management/database-change-1.png)
 2. 在 **工单** 页签中单击 **影子表同步** > **新建影子表同步**。

   ![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/441/700.database-change-management/shadow-table-synchronization-2.png)
 3. 在 **新建影子表同步** 面板中指定以下信息，并单击面板右下角的 **提交**。

      1. 选择对象。

        ![3](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/441/700.database-change-management/shadow-table-synchronization-3.png)

        | **信息项** | **说明** |
        | --- | --- |
        | 数据库 | 选择创建影子表的所属库并可查看当前数据源名称。 |
        | 同步范围 | 选择需要同步的表：      - **部分表**：选定的表在当前库中创建影子表。单击搜索框左侧的全选框，支持全选源表。     - **全部表**：来源库中所有的表都会在当前库中创建影子表。 |
        | 影子表名 | 支持以" **前缀** +源表名"或"源表名+ **后缀** "的格式创建影子表名，并且支持自定义前、后缀。 |
        | 同步对象 | 同步部分表时，需在 **同步对象** 中选择源表以同步为影子表。 |
      2. 单击下一步进行同步影子表结构分析。

        ![4](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/441/700.database-change-management/shadow-table-synchronization-4.png)

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

   ![5](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/441/700.database-change-management/shadow-table-synchronization-5.png)

## 查看影子表同步任务

1. 访问 **工单** > **影子表同步**，影子表同步任务列表中，单击目标任务的名称，查看任务详情。也可以通过操作列的 ··· 对目标任务进行更多操作。

      - 执行：当任务执行方式为手动执行时，主动执行该工单。
      - 终止：当任务执行方式为周期执行或定期执行时，可通过终止结束该工单。勾选目标工单，可通过上方的批量操作按钮进行批量终止。
      - 禁用/启用：当任务执行方式为周期执行或定期执行时，可通过禁用使该任务暂时停止执行，在重新启用后再次生效。
      - 编辑：当任务状态为禁用时，可通过编辑对该任务内容进行更新。
      - 删除：当任务状态为已完成或终止时，可通过删除对该任务进行删除操作。
      - 查看：查看任务内容详情。
      - 克隆：复制该任务执行内容，快速生成相同配置的新建任务界面。
      - 分享：快速复制该任务的访问地址。

   ![5](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/441/700.database-change-management/shadow-table-synchronization-5.png)
 2. 在弹出的任务详情面板中，默认展示该作业的 **基本信息** 页签，可以查看任务类型、数据库、变量配置、执行方式等信息。

   ![6](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/441/700.database-change-management/shadow-table-synchronization-6.png)
 3. 在任务详情面板中，单击 **任务流程** 页签查看发起任务状态、审批状态、执行状态和执行结果等信息。

   ![7](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/441/700.database-change-management/shadow-table-synchronization-7.png)
 4. 在任务详情面板中，单击 **任务日志** 页签查看任务的全部日志和告警日志。

   | 信息项 | 说明 |
   | --- | --- |
   | 全部日志 | 全部日志显示任务的 **INFO**、**ERROR** 和 **WARN** 日志等全量信息。 单击 **查找**、**下载** 和 **复制** 按钮，可查找信息、下载或复制全部日志信息。 |
   | 告警日志 | 告警日志单独显示任务的 **ERROR** 和 **WARN** 日志。当任务失败时，可通过告警日志查看错误信息。 单击 **查找**、**下载** 和 **复制** 按钮，可查找信息、下载或复制告警日志信息。 |

   ![8](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/441/700.database-change-management/shadow-table-synchronization-8.png)

## 相关文档

- [SQL 编辑和执行](https://www.oceanbase.com/docs/common-odc-1000000005551375)
 - [PL 编译和调试](https://www.oceanbase.com/docs/common-odc-1000000005551371)
 - [命令行窗口](https://www.oceanbase.com/docs/common-odc-1000000005551374)
 - [结果编辑与导出](https://www.oceanbase.com/docs/common-odc-1000000005551370)
 - [执行分析](https://www.oceanbase.com/docs/common-odc-1000000005551377)
 - [生成测试数据](https://www.oceanbase.com/docs/common-odc-1000000005551373)
 - [数据库变更管理](https://www.oceanbase.com/docs/common-odc-1000000005551406)
 - [分区管理](https://www.oceanbase.com/docs/common-odc-1000000005551453)
 - [无锁结构变更](https://www.oceanbase.com/docs/common-odc-1000000005551403)

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