库存数据结果定时清理:轻易云单一策略实战教程
这个策略解决什么问题
在旺店通与用友BIP的供应链集成里,平台侧会在调度过程中持续产生中间结果数据:现存量、手机渠道库存、酒水渠道库存、接收中转库存明细账等都会沉淀在轻易云集成平台的运行结果表里。这些数据本身是「过程产物」,调度一结束就该让位给新一批结果。如果长期不清理,结果表会越来越臃肿,查询变慢,甚至影响下一轮调度的入参定位。
我们做这个策略的目的,就是用一条独立于正常同步链路之外的「清理」策略,把指定 target 上的历史结果集按调度周期回收,让平台始终保持「轻装上阵」。
数据流向与字段映射
这条策略不存在源系统到目标系统的常规业务流向,它是一组「平台内部维护」动作:调用轻易云集成平台自身的能力,删除指定 target 上的库存结果集,再写一条空操作占位,保证调度链路完整。
关键字段对照如下:
| 角色 | 字段 | 含义 | 备注 |
|---|---|---|---|
| 源(平台内部) | api = DeleteStrategyData | 调用平台的结果数据删除接口 | 固定 QUERY 类型 |
| 源 | target_1 | 现存量结果集 | 必填 |
| 源 | target_2 | 手机渠道旺店通库存结果集 | 可选 |
| 源 | target_3 | 酒水渠道旺店通库存结果集 | 必填 |
| 源 | target_4 | 接收中转库存明细账结果集 | 可选 |
| 源 | crontab = 0 0 * * * | 每日 0 点触发 | 与目标策略错峰 |
| 目标(平台内部) | api = 写入空操作 | 占位执行 | 不写业务数据 |
| 目标 | crontab = 1 1 1 1 1 | 永不自然触发 | 仅被显式调用 |
这里有两条工程经验值得记住:一是 target 命名要和上游库存策略里写入的 target 严格一致,编码映射建议在轻易云里集中维护,清理策略和写入策略共用同一套命名;二是源策略必须设为可独立触发的 EXECUTE 链路,目标端用空操作避免重复写库。
在轻易云上如何配置
打开轻易云数据集成平台,进入对应集成方案,新建一条「库存数据结果定时清理」策略,配置要点如下:
- 策略类型选「平台内部维护」,明确它不是业务同步策略,避免和正常库存链路混在一起做监控告警。
- 源端选择轻易云平台自身的 DeleteStrategyData 接口,请求体里把 target_1(现存量)、target_3(酒水库存)设为必填,target_2、target_4 视业务保留与否决定是否启用。is_required 的勾选要和上游写入策略严格对齐,否则会出现「上游还在写、清理策略已经删」的撕裂。
- 目标端配置一个「写入空操作」组件,request 与 response 都留空,只保留 id 字段用于链路追踪。这样做的好处是清理动作能在统一调度面板里被看到,又不会污染目标库。
- 调度时间源端用
0 0 * * *,目标端用1 1 1 1 1这种永远不会自然命中的表达式,依靠显式调用触发。轻易云的「表头表体分阶段」模式在这里很有用:清理是表头动作,不涉及表体行项目。 - 编码映射集中管理:target 命名、批次号生成规则统一放在平台的全局变量里,清理策略和写入策略引用同一份,避免两边漂移。
实施步骤
我们一般把这套清理策略分三阶段上线:
阶段一:增量起点对齐。 第一次上线前,先在轻易云里手动跑一次全量库存同步,把所有 target 的当前结果集「封存」为一个基准批次,然后才启用清理策略。这样即便清理策略误删,也能从基准批次回放。
阶段二:全量触发验证。 在轻易云的调试模式里手动触发一次 DeleteStrategyData,观察四个 target 的结果集是否被正确清空,并检查目标端「写入空操作」的链路状态是否为成功、是否真的没有写入业务数据。这里典型错误是有人图省事把目标端也指向真实库存接口,导致清理一次就把库存写空。
阶段三:调度频率固化。 把源端 crontab 锁定为每日 0 点,目标端保持永不自然触发。轻易云客户的常见做法是「增量与全量双轨」:每日的库存同步走增量链路,清理策略单独按日运行,互不干扰。
上线后第一周建议每天人工核对一次结果集大小和下一轮入库耗时,等曲线平稳后再交给自动巡检。
踩坑复盘
- target 命名漂移。上游库存策略里把
target_1改成ys_inventory,清理策略没同步改,结果清了空集、真正的现存量反而越积越多。稳妥的做法是把 target 命名放到轻易云的全局变量里,清理策略和写入策略引用同一变量。 - 误把清理当同步配监控。清理策略没有业务数据产出,却被监控告警系统当成「同步失败」反复叫醒值班同事。建议在轻易云的告警规则里,对内部维护类策略单独分组、单独阈值。
- 目标端接口选错。空操作不是默认行为,必须显式选一个不会写库的执行器;有人图方便把目标端指向上游库存接口,清理一次就把库存清零。这种事故在客户现场至少见过两次。
- crontab 错峰没做。清理策略和正常库存同步用同一个 0 点触发,写入和删除并发,结果集被清掉的同时新批次还没落库,造成下游短暂读到空集。错峰 1–2 个小时基本能规避。
- 没有留基准批次。第一次清理就是裸跑,删完发现上游某条链路其实有历史数据需要保留。增量起点对齐这一步千万别省。
适用场景与不适用场景
适用:旺店通、用友BIP等供应链系统中,结果集长期沉淀在轻易云平台、需要按日回收的库存类目标;多 target、多渠道的库存同步方案。 不适用:业务系统自身的历史库存表清理、需要按业务条件过滤的精细化归档,以及涉及外部审计留痕的库存数据。