结构比对

背景信息

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

执行流程

image

  1. 用户发起结构比对工单。

  2. 审批任务流程。

  3. 执行结构比对任务,并展示结构比对结果。

  4. 新建数据库变更任务以同步结构。

新建结构比对

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

信息项

示例值

所属项目

odc_4.2.0

源端数据源

mysql420

目标端数据源

mysql424

源端数据库名称

odc_test

目标端数据库名称

testdb

源表名称

employee

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

    image

  2. 新建结构比对 页面中,输入以下信息。

    image

    信息项

    说明

    源端数据库

    选择源端数据库。

    目标端数据库

    选择需比对的数据库。

    比对范围

    支持选择 部分表 或者 全部表

    • 部分表:在 对比对象 选择源表 窗口中勾选需要比对的对象。

    • 全部表:比对源端数据库和目标端数据库的所有表对象。

    任务设置

    自动执行 任务。

    描述

    可在 任务描述 文本框中输入不超过 200 个字符的描述信息,该项为选填项。

  3. 单击 新建,完成新建数据库变更。

  4. 任务生成后可以在 工单 > 结构比对 列表中查看任务信息。

    image

  5. 如上图所示,单击 操作 项下的 查看 按钮,查看结构比对详情。

    image

  6. 单击 发起结构同步 发起数据库变更任务。

    image

查看结构比对任务

任务信息

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

    image

  2. 在弹出的任务详情面板中,单击 任务信息 页签查看任务基本信息和设置信息。

    image

  3. 在任务信息面板右下角,单击 发起结构同步/再次发起/下载 SQL,可以新建数据库变更/重新发起任务/下载 SQL 变更脚本。

任务流程

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

image

任务日志

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

信息项

说明

全部日志

全部日志显示任务的INFOERRORWARN日志等全量信息。

单击查找下载复制按钮,可查找信息、下载或复制全部日志信息。

告警日志

告警日志单独显示任务的ERRORWARN日志。当任务失败时,可通过告警日志查看错误信息。

单击查找下载复制按钮,可查找信息、下载或复制告警日志信息。

image

相关文档