--- title: "数据库变更管理 - 开发者中心 ODC V4.4.2 | OceanBase 文档中心" description: 数据库变更管理 背景信息 ODC 支持对数据库中的数据进行变更。用户可以通过数据库变更任务运行耗时较高的 SQL 语句以避免语句执行超时。 本文档以更新表数据为例，介绍如何在表 employee 中将目标行的 name 值修改为 user。 说明 文中所使用的均为示例数据，您可根据实际情况对数据进行替换。 注意事项 … --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*lqS5SYzz_YEAAAAAAAAAAAAADiGDAQ/original) 开发者中心 ODCV 4.4.2 # 数据库变更管理 更新时间：2026-05-22 17:00:50 [编辑](https://github.com/oceanbase/odc-doc/edit/V4.4.2/zh-CN/700.tickets-management/600.database-change.md) ## 背景信息 ODC 支持对数据库中的数据进行变更。用户可以通过数据库变更任务运行耗时较高的 SQL 语句以避免语句执行超时。 本文档以更新表数据为例，介绍如何在表 employee 中将目标行的 name 值修改为 user。 #### 说明 文中所使用的均为示例数据，您可根据实际情况对数据进行替换。 ## 注意事项 - 只支持对 UPDATE 和 DELETE 变更语句自动生成回滚语句。 - 支持的变更影响行数上限为 100W，超过则不支持自动生成回滚语句。 - 若表中包含大字段，不支持自动生成回滚语句。 - OceanBase MySQL、MySQL 数据源下，若表中无主键或者唯一键，不支持自动生成回滚语句。 - UPDATE 语句的修改字段（Set）和条件字段（Where）相同，不支持自动生成回滚语句。 - 最大支持生成的自动回滚语句脚本大小为 256MB。 ## 新建数据库变更任务 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/database-change-2.png) 3. 在 **新建数据库变更** 页面中，输入以下信息，并单击 **新建**。 ![3](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/441/700.database-change-management/database-change-3.png) | 信息项 | 说明 | | --- | --- | | 数据库 | 选择需变更的数据库。 | | SQL 内容 | 选择 **SQL 录入** 或 **上传附件**： - **SQL 录入**：SQL 录入为默认方式，可在编辑区中直接录入 SQL 脚本。 #### 说明 - 在 SQL 录入中，最大允许输入 500000 个字符，如超限可上传附件。 - 单击 **IN 值转化** 按钮，可将批量复制的数据转化成 in（'A','B'）格式。 - 列值分隔符号为换行符。 - 行值分隔符为空格或 TAB 值。 - **上传附件**：选择上传附件方式后，单击文件池进入文件资源管理器选择要导入的文件或者直接将导入文件拖入文件池中以完成文件上传。 #### 说明 - 最多支持上传 500 个文件，总文件大小不超过 256 MB。 - 默认附件按上传的先后排序，可拖拽改变顺序，任务执行时按文件顺序执行。 - 当前只支持上传 .sql 后缀的 SQL 文件。 | | SQL 检查 | 单击该按钮检查 SQL 语法。 | | 回滚方案 | 指定 **回滚方案** 。 回滚方案支持 SQL 文本录入及上传附件方式，参见 **SQL 内容** 信息。 #### 说明 勾选 **生成备份回滚方案**， 支持对 UPDATE/DELETE 语句自动生成备份回滚 SQL。 - OceanBase MySQL 和 MySQL 模式下，自动生成备份回滚方案仅支持对包含主键或者唯一键的表进行 UPDATE/DELETE 时生成对应回滚 SQL。 - 自动生成备份回滚方案支持的单条变更 SQL 的影响行数不超过 10w 行，数据库变更的总影响行数不超过 100w 行。 | | 分隔符 | 支持 Delimiter 分隔符号。 | | 查询结果限制 | 支持设置查询结果限制 (1-100w)。 | | 任务设置 | - **SQL 重试次数**：重试次数大于 1，表示 SQL 语句执行失败后，ODC 会在三分钟后重新执行该 SQL 语句。 - 数据库变更工具提供两种任务错误处理方式： - **停止任务**：停止任务为默认方式，运行脚本的过程中出现错误时会停止运行。 - **忽略错误继续任务**：选择忽略错误继续任务方式，在运行脚本出现错后将跳过错误语句继续执行。 - 选择 **手动执行**/**立即执行** / **定时执行** 设置任务执行方式。 | | 执行超时时间 | 在 **执行超时时间** 文本框中输入数字指定语句执行超时时间，单位为小时（默认超时时间为 48 小时，最大不超过 480 小时）。 | | 描述 | 可在 **任务描述** 文本框中输入不超过 200 个字符的描述信息，该项为选填项。 | 4. 任务生成后可以在 **工单** > **数据库变更** 列表中查看任务信息。 ![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/441/700.database-change-management/database-change-2.png) ## 查看数据库变更任务 1. 访问 **工单** > **数据库变更**，在数据库变更任务列表中，单击目标任务的名称，查看任务详情。也可以通过操作列的 ··· 对目标任务进行更多操作。 - 执行：当任务执行方式为手动执行时，主动执行该工单。 - 终止：当任务执行方式为周期执行或定期执行时，可通过终止结束该工单。勾选目标工单，可通过上方的批量操作按钮进行批量终止。 - 禁用/启用：当任务执行方式为周期执行或定期执行时，可通过禁用使该任务暂时停止执行，在重新启用后再次生效。 - 编辑：当任务状态为禁用时，可通过编辑对该任务内容进行更新。 - 删除：当任务状态为已完成或终止时，可通过删除对该任务进行删除操作。 - 查看：查看任务内容详情。 - 克隆：复制该任务执行内容，快速生成相同配置的新建任务界面。 - 分享：快速复制该任务的访问地址。 - 回滚：当变更工单勾选了回滚方案时，支持快速生成对 UPDATE/DELETE 语句自动生成的备份回滚方案工单。 ![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/441/700.database-change-management/database-change-2.png) 2. 在弹出的任务详情面板中，默认展示该作业的 **基本信息** 页签，可以查看任务类型、数据库、变量配置、执行方式等信息。 #### 说明 您可以在系统设置中对查询结果是否支持查询和下载进行配置，详情请参见 [系统设置](https://www.oceanbase.com/docs/common-odc-1000000005551379)。 ![5](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/441/700.database-change-management/database-change-5.png) 3. 单击 **任务流程** 页签查看发起任务状态、审批状态、执行状态和执行结果等信息。 ![6](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/441/700.database-change-management/database-change-6.png) 4. 单击 **执行结果** 页签查看任务执行记录。 ![7](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/441/700.database-change-management/database-change-7.png) 5. 单击 **回滚工单** 页签查看任务回滚操作记录。 ![8](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/441/700.database-change-management/database-change-8.png) 6. 单击 **任务日志** 页签查看任务的全部日志和告警日志。 | 信息项 | 说明 | | --- | --- | | 全部日志 | 全部日志显示任务的 **INFO**、**ERROR** 和 **WARN** 日志等全量信息。 单击 **查找**、**下载** 和 **复制** 按钮，可查找信息、下载或复制全部日志信息。 | | 告警日志 | 告警日志单独显示任务的 **ERROR** 和 **WARN** 日志。当任务失败时，可通过告警日志查看错误信息。 单击 **查找**、**下载** 和 **复制** 按钮，可查找信息、下载或复制告警日志信息。 | ![9](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/441/700.database-change-management/database-change-9.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-1000000005551453) - [影子表同步](https://www.oceanbase.com/docs/common-odc-1000000005551407) - [无锁结构变更](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) 咨询热线