---
title: "结构比对 - 开发者中心 ODC V4.3.0 | OceanBase 文档中心"
description: 结构比对 背景信息 ODC 的结构比对功能支持将同一项目下、同类型数据源的数据库对象结构进行对比分析，并生成变更脚本。 本文档旨在介绍如何通过 ODC 提交结构比对工单以对比分析两个数据库对象结构。 注意事项 链路支持： OceanBase MySQL 到 OceanBase MySQL。 OceanBase Ora…
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

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

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

# 结构比对

更新时间：2026-04-13 15:30:53

[编辑](https://github.com/oceanbase/odc-doc/edit/V4.3.0/zh-CN/700.database-change-management/900.structural-comparison.md)  

## 背景信息

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** 来查看总的变更脚本内容。

## 执行流程

![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/424/700.database-change-management/900.structural-comparison/1.png)

1. 用户发起结构比对工单。
 2. 审批任务流程。
 3. 执行结构比对任务，并展示结构比对结果。
 4. 新建数据库变更任务以同步结构。

## 新建结构比对

示例：将同一项目 odc_4.2.0 中的两个 OceanBase MySQL 数据源下的 employee 表结构进行对比。

| 信息项 | 示例值 |
| --- | --- |
| 所属项目 | odc_4.2.0 |
| 源端数据源 | mysql420 |
| 目标端数据源 | mysql424 |
| 源端数据库名称 | odc_test |
| 目标端数据库名称 | testdb |
| 源表名称 | employee |

1. 在 **工单** 页签中单击 **结构比对** > **新建结构比对**。

   ![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/424/700.database-change-management/900.structural-comparison/2.png)
 2. 在 **新建结构比对** 页面中，输入以下信息。

   ![3](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/424/700.database-change-management/900.structural-comparison/3.png)

   | 信息项 | 说明 |
   | --- | --- |
   | 源端数据库 | 选择源端数据库。 |
   | 目标端数据库 | 选择需比对的数据库。 |
   | 比对范围 | 支持选择 **部分表** 或者 **全部表** ：    - **部分表**：在 **对比对象** 的 **选择源表** 窗口中勾选需要比对的对象。   - **全部表**：比对源端数据库和目标端数据库的所有表对象。 |
   | 任务设置 | **自动执行** 任务。 |
   | 描述 | 可在 **任务描述** 文本框中输入不超过 200 个字符的描述信息，该项为选填项。 |
 3. 单击 **新建**，完成新建数据库变更。
 4. 任务生成后可以在 **工单** > **结构比对** 列表中查看任务信息。

   ![4](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/424/700.database-change-management/900.structural-comparison/4.png)
 5. 如上图所示，单击 **操作** 项下的 **查看** 按钮，查看结构比对详情。

   ![5.1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/424/700.database-change-management/900.structural-comparison/5.1.png)
 6. 单击 **发起结构同步** 发起数据库变更任务。

   ![5.2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/424/700.database-change-management/900.structural-comparison/5.2.png)

## 查看结构比对任务

### 任务信息

1. 在 **工单** 的结构比对列表中，单击列表操作列中的 **查看** 按钮。

   ![4](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/424/700.database-change-management/900.structural-comparison/4.png)
 2. 在弹出的任务详情面板中，单击 **任务信息** 页签查看任务基本信息和设置信息。

   ![5](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/424/700.database-change-management/900.structural-comparison/5.png)
 3. 在任务信息面板右下角，单击 **发起结构同步**/**再次发起**/**下载 SQL**，可以新建数据库变更/重新发起任务/下载 SQL 变更脚本。

### 任务流程

在弹出的任务详情面板中，单击 **任务流程** 页签查看 **发起任务状态** 、 **审批状态** 、 **执行状态** 和 **完成结果** 等信息。

![6](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/424/700.database-change-management/900.structural-comparison/6.png)

### 任务日志

在任务详情面板中，单击 **任务日志** 标签查看任务的全部日志和告警日志。

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

![7](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/424/700.database-change-management/900.structural-comparison/7.png)

## 相关文档

- [SQL 编辑和执行](https://www.oceanbase.com/docs/common-odc-1000000000876750)
 - [PL 编译和调试](https://www.oceanbase.com/docs/common-odc-1000000000876749)
 - [命令行窗口](https://www.oceanbase.com/docs/common-odc-1000000000876747)
 - [结果编辑与导出](https://www.oceanbase.com/docs/common-odc-1000000000876751)
 - [执行分析](https://www.oceanbase.com/docs/common-odc-1000000000876753)
 - [生成测试数据](https://www.oceanbase.com/docs/common-odc-1000000000876752)
 - [数据库变更管理](https://www.oceanbase.com/docs/common-odc-1000000000876763)
 - [分区管理](https://www.oceanbase.com/docs/common-odc-1000000000876793)
 - [无锁结构变更](https://www.oceanbase.com/docs/common-odc-1000000000876764)
 - [影子表同步](https://www.oceanbase.com/docs/common-odc-1000000000876766)

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