基于湖库一体架构，统一管理结构化、半结构化与非结构化等多模态数据，一个系统承载事务处理、实时分析与 AI 工作负载。
结构比对
更新时间：2026-04-13 15:30:53
编辑
分享
背景信息
ODC 的结构比对功能支持将同一项目下、同类型数据源的数据库对象结构进行对比分析，并生成变更脚本。
本文档旨在介绍如何通过 ODC 提交结构比对工单以对比分析两个数据库对象结构。
注意事项
链路支持：
- OceanBase MySQL 到 OceanBase MySQL。
- OceanBase Oracle 到 OceanBase Oracle。
- MySQL 到 MySQL。
仅支持比对表对象，比对属性范围仅包含列、主键、约束、索引、分区、表属性。
关于列属性，仅支持比对类型、字符集、排序规则、注释、缺省值。
关于分区，仅支持比对一级分区不支持比对二级分区。
关于表属性，仅支持比对字符集、排序规则、注释。
OceanBase MySQL 不支持比对检查约束。
OceanBase MySQL V1.4.79 之前版本，如果没有 sys 租户查询权限，不支持对比分区属性。
若生成的总的 SQL 变更脚本的文件大小大于 1 MB，则不会直接在 SQL 预览 显示内容，而是提示用户文件内容超过最大限制，只能通过 下载 SQL 来查看总的变更脚本内容。
执行流程
用户发起结构比对工单。
审批任务流程。
执行结构比对任务，并展示结构比对结果。
新建数据库变更任务以同步结构。
新建结构比对
示例：将同一项目 odc_4.2.0 中的两个 OceanBase MySQL 数据源下的 employee 表结构进行对比。
| 信息项 | 示例值 |
|---|---|
| 所属项目 | odc_4.2.0 |
| 源端数据源 | mysql420 |
| 目标端数据源 | mysql424 |
| 源端数据库名称 | odc_test |
| 目标端数据库名称 | testdb |
| 源表名称 | employee |
在 工单 页签中单击 结构比对 > 新建结构比对。
在 新建结构比对 页面中，输入以下信息。
信息项 说明 源端数据库 选择源端数据库。 目标端数据库 选择需比对的数据库。 比对范围 支持选择 部分表 或者 全部表 ： - 部分表：在 对比对象 的 选择源表 窗口中勾选需要比对的对象。
- 全部表：比对源端数据库和目标端数据库的所有表对象。
任务设置 自动执行 任务。 描述 可在 任务描述 文本框中输入不超过 200 个字符的描述信息，该项为选填项。 单击 新建，完成新建数据库变更。
任务生成后可以在 工单 > 结构比对 列表中查看任务信息。
如上图所示，单击 操作 项下的 查看 按钮，查看结构比对详情。
单击 发起结构同步 发起数据库变更任务。
查看结构比对任务
任务信息
在 工单 的结构比对列表中，单击列表操作列中的 查看 按钮。
在弹出的任务详情面板中，单击 任务信息 页签查看任务基本信息和设置信息。
在任务信息面板右下角，单击 发起结构同步/再次发起/下载 SQL，可以新建数据库变更/重新发起任务/下载 SQL 变更脚本。
任务流程
在弹出的任务详情面板中，单击 任务流程 页签查看 发起任务状态 、 审批状态 、 执行状态 和 完成结果 等信息。
任务日志
在任务详情面板中，单击 任务日志 标签查看任务的全部日志和告警日志。
| 信息项 | 说明 |
|---|---|
| 全部日志 | 全部日志显示任务的 INFO 、 ERROR 和 WARN 日志等全量信息。 单击 查找 、 下载 和 复制 按钮，可查找信息、下载或复制全部日志信息。 |
| 告警日志 | 告警日志单独显示任务的 ERROR 和 WARN 日志。当任务失败时，可通过告警日志查看错误信息。 单击 查找 、 下载 和 复制 按钮，可查找信息、下载或复制告警日志信息。 |
