2.3 KiB
[TOC]
开发者工具脚本
StandardVmapGen
OGController
FastCheck
工具升级指导
什么时候工具要升级
首先我们需要明确如下几点： 1、工具的核心数据是一批规则，规则的中心是SQL 2、VMAP的本质是工具内的SQL及其查询结果 3、工具将自身SQL在数据库内进行查询，并将查询结果与VMAP内预期结果进行对比。
而当工具内的规则发生变化，便需要升级工具，并生成对应的VMAP。
一些典型的场景如下：
- openGauss元数据发生变化，导致工具内有些规则内的SQL执行报错，或者不再合理时
- 工具内的
需要注意的是，单纯的openGauss元数据变化，并不代表需要升级工具。
怎么去给工具做升级
1、按照自己的需求，修改工具内的校验规则。
2、将version.py中UPGRADE_CHECKER_VERSION进行修改加一。
3、下载version.py中VERSION_SUPPORT所列出来的openGauss版本压缩包，进行测试。
4、为测试通过的版本使用Dev/StandardVmapGen.py来导出基准校验地图。
5、更新根目录下《README.MD》内版本支持列表
6、将新的基准校验地图上传至openGauss华为云obs存储位置。
适配openGauss新版本
当openGauss发布新版本时，并不代表着需要升级工具，但一定需要为新版openGauss生成一个新的VMAP。
首先我们需要安装运行一个openGauss新版本，并且下载本工具，之后按照如下步骤适配openGauss最新版：
1、使用当前工具，对openGauss新版本进行VMAP导出测试。
- 判断version.py中的VERSION_SUPPORT是否需要修改。
- 使用工具导出新版本openGauss的VMAP。可正常导出，或用Dev/StandardVmapGen.py
2、修复导出测试过程中的告警、错误并重新测试导出，直到完美导出VMAP。
3、使用导出的vmap，对openGauss新版本进行check校验。
4、修复校验过程中的告警、错误，校验报告中的告警、错误，并从头重新测试，直到完美的完成校验报告。
5、检查上述过程中的修改是否涉及到工具升级。若涉及则需要升级工具。
6、使用新的VMAP进行openGauss老版本到当前新版本的升级测试。
6、将新的标准VMAP(还有工具升级涉及生成的新的)，上传到openGauss华为云obs存储位置。