---
title: "数据归档 - 开发者中心 ODC V4.3.0 | OceanBase 文档中心"
description: 数据归档 本文档旨在介绍如何通过提交数据归档工单实现归档数据。 背景信息 ODC 支持定时将源数据库中的表数据归档至其它目标数据库中，以解决因线上数据增多影响查询性能与业务运作的问题。 本文档以新建数据归档为例，介绍如何在 ODC 中将同一项目的数据库 odc_test 中的表 employee 归档到数据库 tes…
---
切换语言

- 中文站 - 简体中文
- 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/800.data-Lifecycle-management/100.data-archiving.md)  

本文档旨在介绍如何通过提交数据归档工单实现归档数据。

## 背景信息

ODC 支持定时将源数据库中的表数据归档至其它目标数据库中，以解决因线上数据增多影响查询性能与业务运作的问题。

本文档以新建数据归档为例，介绍如何在 ODC 中将同一项目的数据库 odc_test 中的表 employee 归档到数据库 test2 中。

#### 说明

文中所使用的均为示例数据，您可根据实际情况对数据进行替换。

## 原理介绍

![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/423/800.data-Lifecycle-management/100.data-archiving/1.0.png)

## 前提条件

归档的表中必须包含主键。

## 注意事项

- 前置条件：

     - OceanBase 数据源必须通过 OBproxy 连接（暂不支持对直连的 OceanBase 进行归档操作）。
     - OceanBase 数据源目前仅支持集群实例，新建数据源时必须配置集群名称。
     - 需保证源端表字段在目标端兼容，数据归档不处理字段兼容性问题。
     - MySQL 数据源暂不支持 CPU 内存防爆能力。
 - 归档链路支持：

     - OceanBase MySQL 到 OceanBase MySQL。
     - OceanBase Oracle 到 OceanBase Oracle（暂不支持同步表结构）。
     - MySQL 到 MySQL。
     - MySQL 到 OceanBase MySQL。
     - OceanBase MySQL 到 MySQL。
 - 以下情况不支持归档：

     - OceanBase MySQL 及 MySQL 数据源若表中不包含主键 PRIMARY KEY 或唯一非空索引，不支持进行归档。
     - OceanBase Oracle 数据源若表中不包含主键 PRIMARY KEY，不支持进行归档。
     - OceanBase Oracle 数据源若表中包含 JSON、XMLTYPE 字段类型，不支持进行归档。
     - OceanBase Oracle 数据源不支持 V4.3.0 及以上版本。
     - OceanBase MySQL 数据源不支持 V4.3.1 及以上版本。
     - 若归档条件中包含 limit 语句，不支持进行归档。
     - 若表中包含外键，不支持进行归档。

## 新建数据归档

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

   ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/430/800.data-Lifecycle-management/100.data-archiving/1.png)

   ```sql
   CREATE TABLE `employee` (
   `emp_no` int(120) NOT NULL COMMENT 'employee number',
    `birthday` date DEFAULT NULL COMMENT 'employee birthday',
    `name` varchar(120) DEFAULT NULL COMMENT 'employee name',
    `time` date NOT NULL COMMENT 'time' COMMENT 'create time',
    PRIMARY KEY (`time`)
   ) partition by range columns(time) (
    partition p2023_01
    values
     less than ('2023-01-01'),
     partition p2023_02
   values
     less than ('2023-02-01')
   )

   ```
 2. 在 SQL 开发窗口的 **任务** 页签中，单击 **数据归档** > **新建数据归档**。

   ![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/430/800.data-Lifecycle-management/100.data-archiving/2.png)
 3. 在 **新建数据归档** 页面中，输入以下信息。

   ![3](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/430/800.data-Lifecycle-management/100.data-archiving/3.png)

   | 信息项 | 说明 |
   | --- | --- |
   | 源端数据库 | 选择表所属的数据库。   #### 说明    ODC V4.2.2 及之后的版本支持选择 MySQL 数据库，以将 MySQL 中的数据归档到 OceanBase 数据库中。 |
   | 目标数据库 | 选择表归档的数据库。   #### 说明    ODC V4.2.2 及之后的版本支持选择 MySQL 数据库，以将 OceanBase 中的数据归档到 MySQL 数据库中。 |
   | 归档范围 | - 部分归档：通过过滤条件归档源端数据库中部分表。          - 可使用常量或者引用变量配置中定义的变量来配置过滤条件。例如：`time<'${create_time}'`，其中 `create_time` 为变量配置中的变量名，`time` 为归档表中的字段。         - 勾选 **指定分区**，支持根据指定的分区归档数据。   - 整库归档：归档源端数据库中所有表。 |
   | 自定义变量 | 可选项。通过定义变量和设置时间偏移量筛选表中符合条件的行进行归档。 |
   | 执行方式 | 选择 **立即执行** / **定时执行** / **周期执行** 设置任务执行方式。 |
   | 任务设置 | - 指定任务时长：任务启动指定时长后，若未完成则会暂停调度，等待下一次调度。   - 开启目标表结构同步：任务调度前进行一次表结构比对，若源端和目标端表结构不一致，将跳过该表。   - 插入策略：执行数据归档时，忽略重复数据/更新重复数据。   - 限流策略：配置行限流和数据大小限流。 |
   | 备注 | 可在 **备注** 文本框中输入不超过 200 个字符的描述信息，该项为选填项。 |
 4. 单击 **新建** 后，预览归档 SQL 语句并单击 **确定**，完成新建数据归档。

   ![4](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/430/800.data-Lifecycle-management/100.data-archiving/4.png)
 5. 任务生成后可以在 **工单** > **数据归档** 列表中查看任务信息。

   ![5](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/430/800.data-Lifecycle-management/100.data-archiving/5.png)

## 查看数据归档任务

### 任务信息

1. 如上图所示，在 **工单** 的数据归档列表中，单击操作列中的 **查看** 按钮。
 2. 在弹出的任务详情面板中，单击 **任务信息** 页签查看任务类型、源数据库、目标数据库、变量配置、归档范围和执行方式等信息。

   ![6](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/430/800.data-Lifecycle-management/100.data-archiving/6.png)

### 执行记录

在任务详情面板中，单击 **执行记录** 页签查看任务状态和执行详情等操作。

![7](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/430/800.data-Lifecycle-management/100.data-archiving/7.0.png)

### 操作记录

在任务详情面板中，单击 **操作记录** 页签查看任务的任务审批状态和记录。

![8](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/430/800.data-Lifecycle-management/100.data-archiving/8.png)

## 相关文档

- [数据清理](https://www.oceanbase.com/docs/common-odc-1000000000876744)

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