创建数据清理归档工单--数据库工作台-火山引擎

文档中心

导航

创建数据清理归档工单

最近更新时间：2025.02.27 11:41:46首次发布时间：2024.10.28 19:24:01

数据清理归档工单主要用于删除历史数据。本文介绍如何在数据库工作台 DBW 创建数据清理归档工单。

前提条件

已创建云数据库 MySQL 版实例。详细操作，请参见创建实例。
已开启实例的安全管控。详细操作，请参见开启安全管控。
已添加为 DBW 角色的用户。详细操作，请参见添加用户。
已授予添加为 DBW 角色用户相关权限。详细操作，请参见权限管理。

注意事项

当前仅支持创建数据清理工单，暂不支持创建数据归档工单进行数据归档。
仅支持对有 SQL 变更权限的数据库对象创建数据清理归档工单。
偏移时间以任务执行时间（时区为 UTC + 8）开始计算。
任务开始执行与配置时间可能有 1~2 分钟的误差。
单次执行时，归档的时间处理以点击执行时间为准。
建议删除的数据不要千万级，否则可能会导致数据删除不成功。
关于数据清理归档的详细信息，请参见数据清理归档简介。

操作步骤

登录 DBW 控制台。
在顶部菜单栏，选择目标地域。
在左侧导航栏，选择数据管理 > 工单列表。
在工单列表页面，单击数据清理归档。
在数据清理归档页签，单击创建清理归档工单。

在创建清理归档工单控制面板，配置以下参数信息。

类别	参数	说明
基本信息	创建人	默认为当前登录的账号，且不支持修改。
	工单标题	（可选）自定义工单标题。工单标题的长度不能超过 200 个字符。
	数据库类型	选择云数据库 MySQL 版。
归档配置	实例	从下拉列表中选择需要进行数据清理归档且已开启安全管控的实例。
	数据库	从下拉列表中选择需要进行数据清理归档的数据库。
	归档表	从下拉列表中选择需要进行数据清理归档的表。您也可以在过滤条件输入框中输入表内数据的过滤条件，例如目标清理表中存在序号列，需过滤掉序号小于 10 的列不被清理，那么过滤条件输入框需配置为`序号 < 10`。
	归档类型	周期性归档：当前支持按小时、天、周、月或 Cron 表达式进行周期性清理归档数据。详细信息，请参见周期配置。单次归档：如果选择单次归档，那么数据清理归档则在工单审批结束后手动执行单次运行任务。
	数据备份	当前暂不支持选择，默认不支持在清理归档数据时保存数据备份。
	变量配置	配置该变量可以在配置归档过滤条件时使用。最多可添加 10 个变量，多个变量会以 `AND` 的方式同时拼入 where 条件中。说明设置的变量名是目标归档表中存在的，同时时间格式也是目标归档表中存在的字段格式。例如表格中包含 `CreateTime` 和 `ModifyTime` 两个时间字段，且字段时间格式为 `yyyy-mm-dd`，您需要删除清理偏移时间在 10 天前新增并在 5 天前修改的数据，那么您需要添加 2 个变量，且变量的配置信息如下所示：变量 1：变量名为 `CreateTime`，时间格式为 `yyyy-mm-dd`，时间运算为 -、10、日，如果当前日期为 `2024-12-03`，那么生成的 where 语句为 `CreateTime` < '2024-11-24'；如果当前日期为 `2024-12-04`，那么生成的 where 语句为 `CreateTime` < '2024-11-25'。变量 2：变量名为 `ModifyTime`，时间格式为 `yyyy-mm-dd`，时间运算为 -、5、日，那么生成的 where 语句为 `CreateTime` < '2024-11-24'，那么生成的 where 语句为 `ModifyTime` < '2024-11-29'。；如果当前日期为 `2024-12-04`，那么生成的 where 语句为 `CreateTime` < '2024-11-30'。
	工单备注	自定义您的工单备注，建议和您的业务相关，方便后续查找。
	审批流程	审批流程当前包含一级审批、二级审批和三级审批，同数据变更审批流程一致，分别为在开启实例安全管控时设置的 Owner、DBA 和 Admin。

单击下一步。
在创建清理归档工单控制面板的工单确认配置向导页面，确认执行的删除语句后，单击提交工单。
本文参数示例生成的的 SQL 语句如下所示：
- 当前时间为 2024-12-03时，生成的语句如下所示：
```
delete from `test_db`.`common_types_table`   where (序号 < 10) AND  `createtime` < '2024-11-24'  AND  `modifytime` < '2024-11-29'    
```
- 当前时间为 2024-12-04时，生成的语句如下所示：
```
delete from `test_db`.`common_types_table`   where (序号 < 10) AND  `createtime` < '2024-11-25'  AND  `modifytime` < '2024-11-30'    
```

周期配置

参数			说明
间隔周期	小时	执行时间	执行时间支持以下选择：指定间隔：在固定的时间范围内，按照指定间隔时间执行任务。指定时间：在一天内的某个指定时间执行任务。
		时间范围	在执行时间选择指定间隔时，支持选择执行范围内的开始时间和结束时间。
		间隔时间	在执行时间选择指定间隔时，支持设置执行任务的间隔时间，间隔时间的取值范围为 [1, 23]。
		指定时间	在执行时间选择指定时间时，勾选整点执行任务，支持多选。例如选择 00:00 和 07:00，则系统将在 0 点和 7 点执行任务。
	天	具体时间	以天为周期，设置每日执行一次任务的具体时间。
	周	指定时间	以周为周期，按需勾选星期几执行任务，支持多选。
	周	具体时间	设置每次执行任务的具体时间。例如指定时间设置在星期一、星期三、星期五，具体时间设置在 02:30，那么将在每周的周一、周三和周五的凌晨两点半执行任务。
	月	指定时间	以月为周期，按需勾选每月几号执行任务，支持多选。说明由于月份的天数不一样，支持选择每月最后一天执行任务。
	月	具体时间	设置每次执行任务的具体时间。例如指定时间设置在每月 1 号、每月 15 号和每月最后一天，具体时间设置在 05:00，那么将在每个月的 1 号、15 号和每月的最后一天执行任务。
	Cron 表达式	Cron 表达式	不需要手动配置，系统会根据您配置的周期、具体时间自动展现。