用途:运行完整的数据集更新流程,串联PR创建、快照、meadow、garden、grapher等步骤,并在每个编号步骤后进行强制检查点,等待用户批准后才继续。
主要能力:解析输入(命名空间、旧版本、名称),用当天日期确定新版本;清理或复用工作台目录;通过etl-update子代理执行更新(帮助→试运行→批准→正式运行);创建或复用草稿PR与工作分支;更新快照并与旧版本比较;逐步运行并修复meadow、garden、grapher步骤,产出差异与摘要;可选执行indicator upgrade并校验;起草Slack公告。进度写入workbench/<short_name>/progress.md并带时间戳。
使用方式:输入为<namespace>/<old_version>/<name>,用date -u +"%Y-%m-%d"获取新版本;可选参数branch。示例:update-dataset data://snapshot/irena/2024-11-15/renewable_power_generation_costs 2023-11-15 update-irena-costs。每个步骤完成后必须执行CHECKPOINT,只有回复yes才继续。etl update需对完整步骤URI只运行一次,避免逐通道运行导致dag/main.yml版本引用过期。
限制与注意:缺失或含糊回复视为no;绝不返回空表或注释掉逻辑作为变通;列名变更需同步更新garden处理代码与元数据YAML;注意reset_index()索引泄漏,使用tb.format(["country","year"]);元数据校验错误应作为指引修正YAML。
适用场景:需要刷新或更新数据集的端到端工作流程,尤其是含多步骤转换与PR管理的场景。其余细节暂未提供。