管理分区计划

本文档旨在介绍如何在 ODC 上使用分区计划，包括对新建和删除的表分区进行自动管理。

背景信息

分区计划是专门针对 Range 分区的扩展功能，ODC 支持依据用户设置的分区策略对 Range 分区表进行自动管理，用户无需手动创建新分区，以方便维护 Range 分区表。

• Range 分区：Range 分区是最常见的分区类型，通常与日期一起使用。在进行 Range 分区时，数据库根据分区键的值范围将行映射到分区。详情请参见 设置分区规则 和 分区类型。

• 分区计划：在 Range 分区表中插入数据时，如果插入的数据超出当前分区的区间上限值，将无法插入数据并且会返回错误。

• 创建策略：表按照指定的时间间隔和数据范围将数据划分到对应的分区。创建分区策略方式包括顺序递增和自定义。

  • 顺序递增：创建分区策略方式，仅适用于时间字段类型。

    

  • 自定义：创建分区策略方式，所有字段类型支持通过自定义 SQL 表达式创建分区策略。

    

• 删除策略：根据设置的分区保留数量保留最新的分区并删除多余的分区。

分区计划执行流程

1. 对表设置创建分区策略/删除分区策略。
2. 指定策略执行周期。
3. 审批任务流程。
4. 执行分区计划。

注意事项

• 仅支持 OceanBase MySQL 和 OceanBase Oracle 数据源。

• 仅支持 Range 分区表。

• Range 分区表中的最后一个分区上限值为 MAXVALUE 时，数据库不允许新增分区，因此不支持通过 ODC 分区计划任务创建分区策略。

• 分区计划默认每小时的 00 分 00 秒执行。

• 数据库已存在一个分区计划时，新创建的分区计划审批通过后覆盖原有分区计划。

• 表如果属于表组（tablegroup），创建分区可能会失败或破坏负载均衡，请谨慎配置创建策略。

• 新建分区可能会导致表组（tablegroup）失效，因为同属于一个表组的表必须拥有完全一致的分区，而新建分区可能会破坏这种现状，导致表组失效。

• 表如果包含全局索引，删除分区会导致全局索引失效，请谨慎操作；如果选择重建全局索引可能因耗时较久导致业务问题，或者重建全局索引失败导致线上问题。

• 重建全局索引选项仅对 Oracle 模式有效，MySQL 模式下无此选项，因 MySQL 模式下默认会重建全局索引。

创建分区计划

示例：在数据源 mysql424 下数据库 test_424 中，每隔 1 个月预创建 1 个 order 表分区。

1. 在 SQL 窗口中，编辑 SQL 语句以创建表 order。

   

   CREATE TABLE `order` (
   `time` date NOT NULL,
    `parti_key` int(11),
    `name` varchar(120) DEFAULT NULL
   ) partition by range columns(time, parti_key)
   (partition p2023_01 values less than ('2023-01-01', 20230101),
   partition p2023_02 values less than ('2023-02-01', 20230201))
   

2. 在 SQL 开发窗口的 工单 页签中单击 分区计划 > 新建分区计划。

   

3. 在 新建分区计划 面板中指定以下信息。

   

   信息项	说明
   数据库	选择创建分区计划所属数据库。
   分区策略	勾选所属库中的 Range 分区表，并单击编辑对应的分区策略。具体配置请参见 设置分区策略 和 分区策略使用示例。 说明 勾选 分区策略 右侧的 仅显示未设置的表 时，支持过滤未设置的表。 勾选 Range 分区表时，支持批量设置分区策略。
   设置策略执行周期	创建策略执行周期：设置所有的分区创建策略的执行时机，例如每晚 2 点执行。 删除策略执行周期：勾选自定义删除策略执行周期，设置所有的分区删除策略的执行时机，如果勾选，分区删除策略将会和分区创建策略一起被调度执行。 示例：创建策略执行周期每晚 3 点，删除策略执行周期每晚 1 点。表示每晚 3 点将会运行该数据库下所有的分区创建策略，每晚 1 点将会运行该数据库下所有的分区删除策略。
   任务设置	选择任务错误处理方式： 停止任务：停止任务为默认方式，运行脚本的过程中出现错误时会停止运行。 忽略错误继续任务：选择忽略错误继续任务方式，在运行脚本出现错后将跳过错误语句继续执行。
   执行超时时间	默认 2 小时。
   备注	描述项目的业务背景信息，例如变更目的、预期目标等。

4. 指定上述信息后，单击面板右下角的 提交 按钮完成创建分区计划任务。

5. 任务生成后会自动弹出 任务中心 面板，在任务中心可以查看任务审批状态和任务信息。

   

查看分区计划

任务信息

1. 在 工单 的分区计划列表中，单击操作列中的 查看 按钮。

   

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

   信息项	说明
   任务基本信息	显示 任务状态 、 任务编号 、 任务类型、所属数据源、 风险等级、备注、创建人 和 创建时间 等信息。
   任务设置信息	显示创建分区计划任务时所选择的 Range 分区表的分区策略信息。

3. 在任务信息面板右下角，单击 再次发起 ，可以重新发起任务。

任务流程

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

   

2. 在面板右下角，单击 再次发起 ，可重新发起任务。

关联记录

1. 在 任务详情 面板中，单击 关联记录 页签查看 任务编号 、 所属库 、 创建时间 、 任务状态 和 查看 操作等信息。

   

2. 在面板右下角，单击 再次发起 ，可重新发起任务。

任务日志

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

   

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

2. 单击 再次发起 ，可重新发起任务。

相关文档

• 设置分区策略

• 分区策略实例