旧版聚合表升级助手
1. 简介
1.1 功能简介
通过升级助手,可以帮助用户快速将旧版聚合表升级为新版聚合表,并自动替换相关表单/仪表盘中的引用,全面提升聚合表的使用体验。
1.2 使用前提
在使用升级助手前,需注意以下几点:
- 建议空闲时操作,避免影响调用聚合表数据的表单业务;
- 已升级的聚合表支持在 30 天内恢复为旧版,超期后无法恢复;
- 用户可使用升级助手一键升级,或等待官方统一升级。
1.3 预期效果
以将旧版聚合表升级为新版为例,效果如下所示:
2. 设置步骤
2.1 设置入口
进入「应用后台 >> 聚合表」,在旧版聚合表处,点击「升级助手 」即可打开。
2.2 选择操作类型
在升级助手中,支持以下两种操作类型,选择对应操作类型即可:
- 升级为新版聚合表:将选定的旧版聚合表升级为新版;
- 恢复至旧版聚合表:将已升级的新版聚合表退回至旧版。
注:已升级的聚合表支持在 30 天内恢复为旧版,超期后无法恢复。
2.3 选择聚合表
根据上一步选择的操作类型,在当前应用中选择相应的旧版聚合表进行升级或将已升级聚合表恢复至旧版。
2.4 升级失败
在升级时,会自动校验各配置条件,少数旧版聚合表无法直接升级为新版,需手动点击「生成新版聚合表」后,再调整配置,具体可参考文档:旧版聚合表升级失败处理方案。
3. 注意事项
1)若应用中无旧版聚合表,将不显示升级助手入口。
2)升级后的聚合表一经修改将无法恢复至旧版聚合表。
3)旧版聚合表中通过加减非必要变量满足配置的指标公式,升级新版时将自动简化。化简结果可能为0 * COUNT(x),不影响指标使用,用户可保留或手动删除该部分表达式。
4)旧版聚合表数据提交校验条件中的失效变量,即:指标被删除后校验公式中原有的指标会转为「失效变量」,升级时会保留原有的校验条件,其中的失效变量会被替换为 0。
5)由于部分旧版聚合表的来源表、维度、过滤条件可能超限,不能无缝兼容的聚合表需通过特殊兼容处理进行升级,为不影响用户使用,将生成「升级适配版」的聚合表,兼容旧版特殊逻辑并正常运行。
注:当在应用内复制聚合表、企业内复制应用、外链安装应用时,复制后的聚合表为常规聚合表,但需修改为正确配置后方可进行全量计算。
6)存在多余数据源表单时,指标中会新增一个「升级适配指标」以辅助升级,不影响聚合表正常使用,用户可自行删除并根据提示删除多余的数据来源表。