在创建数据清理归档工单时，需要配置变量定义归档策略、控制归档操作行为和制定归档参数。数据清理归档的变量可以帮助您自动化和优化数据清理归档的过程，从而可以更有效地管理和归纳数据库的数据，进而提高数据库的查询性能和业务运转。 ## 背景信息在数据库的数据清理归档中，使用变量可以大大提升任务的灵活性和可配置性。这些变量可分为系统变量、时间变量和非时间变量，并且在任务节点中以 `${varName}` 的形式动态引用。 |**变量类型** |**区别** | |---|---| |系统变量 |系统变量通常是由系统预定义的变量，用于在任务流程动态引用系统信息，例如任务 ID、执行时间、执行任务的用户等。 | |时间变量 |时间变量常用于处理和引用与时间相关的信息，便于进行时间相关的数据操作，例如按日期归档数据。关于时间变量的时间格式请参见时间格式。 | |非时间变量 |非时间变量可以是您自定义的变量，用于传递在任务流中使用的动态值。它们可以是字符串、数值或其他类型的数据，例如归档的目标表名、数据源表名等。 | ## 注意事项 * 偏移时间：在调度时的`当前时间`+ 配置时间偏移。如果是单次任务，那么调度时间为点击执行的时间。 * 偏移具体时间以执行为准，由于调度原因或存在 1~2 分钟左右的误差。 * 偏移时间处于 UTC+8 时区，需自行在进行时间运算时推算出准确时间。 * 时间偏移 `-` 为向前偏移，`+` 为向后偏移，`+`、`-` 均为小于时间判断，举例如下：配置定时删除时间为每日早上的 08:00，假设删除任务在 2024 年 10 月 02 日早上 08:00 点执行，时间偏移配置和 where 语句如下所示： * 时间偏移配置 `- 24` 小时，时间格式为 `yyyy-mm-dd hh:MM:ss`，那么生成的 where 条件为 `time` < '2024\-10\-01 08:00:00' * 时间偏移配置 `+ 24` 小时，时间格式为 `yyyy-mm-dd hh:MM:ss`，那么生成的 where 条件为 `time` < '2024\-10\-03 08:00:00' * 可以配置多个变量，多个变量会以 `AND` 的方式同时拼入 where 条件中。 ## 时间变量的相关配置 |**时间变量** |**描述** |**输入示例** |**返回示例** | |---|---|---|---| |年 |yyyy：表示当天所在的年份。 |yyyy |2024 | |月 |m 当前年份的第 N 个月，mm 的返回值为 [01,12]。 |mm |08 | |天 |d 表示当前月份的第 N 天，d 的返回值为 [1,31]，dd 的返回值为 [01,31]。 |d |360 | |小时 |h 表示当天的第 N 个小时，0 表示 0 点。h 的返回值为 [0, 23]，hh 的返回值为 [00, 23]。 |hh |10 | |分钟 |M 表示分钟数，MM 的返回值 [00, 59]。 |MM |27 | |秒 |* s 表示秒数。|ss |08 |\ | |* S 表示毫秒数。 | | | |时区 |Z 表示时区。 |Z |UTC+08:00 | |时间戳 |* ss：表示秒级别的时间戳。|ss |09 |\ | |* ss.SS：表示毫秒级别的时间戳。 | | | :::tip T：表示日期和时间的分隔符。 ::: 时间格式的组合示例： |**输入示例** |**返回示例** | |---|---| |`yyyy-mm-dd` |2024\-08\-12 | |`yyyy-mm-dd hh:MM:ss` |2024\-08\-12 09:12:12 | |`yyyy-mm-ddThh:MM:ssZ` |2024\-10\-26T00:12:00Z | |`yyyy-mm-ddThh:MM:ss.SSSZ` |2024\-10\-23T00:15:00.000Z | ## 相关文档变量用于在创建数据清理归档中过滤数据的条件时使用。详细操作，请参见： * [创建 MySQL 数据清理归档工单](../6956/1356570) * [创建 veDB MySQL 数据清理归档工单](../6956/1356574)

数据库工作台