1. 概述
1.1 版本
| FineDataLink 版本 | 功能变动 |
|---|---|
| 4.2.17.3 | 生产模式下，运行按钮下新增「补历史数据」功能 |
1.2 应用场景
FineDataLink 目前提供了 重试任务 功能，目的是期望某些任务运行失败/数据异常时，若用户手动解决了错误，可以基于原实例的运行时间，手动重新触发实例运行。同时也支持补历史的数据，支持让用户自定义任务运行的参数。
但有些用户需要指定日期区间补数，目前的单个时间参数无法满足批量的需求。
1.3 功能简介
补数据时支持指定一个业务日期范围，再基于调度配置，生成多个实例完成补数据操作。如下图所示：
1.4 知识扩展
「运维中心>定时任务>运行记录」处，可以 选择实例进行重试；定时任务发布后，也可以补充历史数据（本文内容） 。二者区别说明如下：
| 重试实例 | 补历史数据（本文内容） | |
|---|---|---|
| 相同点 | 本质上都是指定业务日期去触发任务运行，且配置结果只影响本次执行，不修改实际任务配置 | |
| 区别 |
| 在任务上触发运行，可以选择指定时间或者时间区间，如果是时间区间，可以生成多个实例，满足补数据的需求 |
| 查看运行记录 |
|
|
2. 功能说明
2.1 补历史数据
定时任务发布后，可指定日期区间补数。如下图所示：
| 设置项 | 说明 |
|---|---|
| 补数范围 | 支持两种： 1）仅当前任务补数 2）当前任务及下游补数：按照最新配置重试当前任务，产生的运行记录将参与事件调度的执行条件判断，根据判断结果，触发下游运行 可点击「查看事件调度」按钮，查看该任务的下游任务组
|
| 指定业务日期区间&执行频率 | 指定业务日期区间：
执行频率： 只支持简单重复执行，可设置固定执行频率 控制每隔多少时间生成一个补数实例
示例：
定时任务中使用了 自定义时间参数 aa，值为 yyyy-mm-dd，2026-04-16 发现由于网络原因，原本 2026-04-11、2026-04-12、2026-04-13 的实例运行失败，想重跑任务进行补数，可指定业务日期区间为 2026-04-11 hh:mm:ss（由于参数值为 yyyy-mm-dd，hh:mm:ss可随意设置）至2026-04-13 hh:mm:ss，此时会生成三个实例，aa 的值分别为 2026-04-11、2026-04-12、2026-04-13 实例运行逻辑：按业务日期顺序运行，前一个实例运行完毕后后一个实例再进行构建 |
| 任务优先级 | 为避免补数任务抢占其他任务运行资源，建议调低此处优先级；配置结果只影响本次任务产生的实例，不修改实际任务配 置相同优先级的实例按照先进先出的顺序执行 |
| 运行失败策略 | 勾选后，执行过程中某次实例运行失败时，后续实例继续生成 |
2.2 终止补数执行
1）点击「运维中心>定时任务>运行记录」，可终止单个实例或者批量终止实例。
2）此处点击「终止全部」，将中断所有补数实例。
生产模式下的「终止」按钮，需谨慎点击，将中断当前任务产生的所有实例。
2.3 查看补数运行记录
1）补数成功后，可到「运维中心>定时任务>运行记录」处，触发方式选择「补数触发」，查看运行记录。
2）点击「查看详情」按钮，可查看补数记录。
3. 示例
3.1 场景模拟
3.1.1 任务设置说明
定时任务每天执行，将「到货日期」为当天的数据写入到目标表中。如下图所示：
3.1.2 场景说明
2026-04-16 日发现，因业务库异常，导致目标表中缺少 2026-04-11、2026-04-12、2026-04-13 这三天的数据。如下图所示：
3.2 执行补数据操作
1）业务库修复完成后，打开该任务，在生产模式下点击「补历史数据」按钮，进行补数据。
主要设置项说明如下：
| 设置项 | 说明 |
|---|---|
| 执行频率 | 本示例中，data 参数的值只精确到天，执行频率设置为每隔一天执行一次即可 |
| 指定业务日期区间 | 缺少 2026-04-11、2026-04-12、2026-04-13 这三天的数据，我们需要保证能生成三个实例，这三个实例的业务日期能覆盖这三天的，上图三个业务日期的值分别为 2026-04-11 09:00:00、2026-04-12 09:00:00、2026-04-13 09:00:00（该值小于业务日期结束值：2026-04-13 13:01:04） 若「指定业务日期区间」的结束日期设置为 2026-04-13 08:00:00，那么只能产生两个实例，分别为：2026-04-11 09:00:00、2026-04-12 09:00:00，将无法对 2026-04-13 补数 |
2）点击「确定」按钮后，提示将产生三个实例，点击「确定」按钮进行补数。
3.3 查看补数记录
1）「运维中心>定时任务>运行记录」处，触发方式选择「补数触发」，查看运行记录。
可看到每个实例对应的业务日期。
2）选择一个实例，点击「查看详情」按钮，查看该实例的日志。
3.4 效果查看
查看目标表，可看到数据已补录。
上一篇：Cron表达式设置
