概述
软件开发过程中,往往会遇到版本管理问题,也常常会遇到服务多版本管理问题,也常常会遇到不同版本的服务之间,数据库字段不同、建表语句不同的问题,那么如何在不同版本间进行平滑升级,那么就需要有一系列的规范(暂不涉及回退方案):
升级步骤
自动化管理,由程序在启动前操作:
1. 检查数据库中的当前版本,检查程序版本(version.properties中)
2. 检查与当前版本相关联的升级脚本(这一步骤依赖于与数据库版本相对应的文件命名规范)
3. 如果找到了文件,则执行文件内容并验证输出,如果出现错误则退出,抛出异常
4. 如果没有发现脚本,则直接退出,抛出异常
5. 重复步骤1
注意事项
1. 版本控制:
数据库中存在db_schema_version表,用来管理当前所有应用实例的版本信息,每个项目中,都应包含一个version的描述文件(version.properties),有版本变动,即修改其版本信息,db_schema_version表结构见第6条
2. 版本号控制:<主版本号>.<子版本号>.<修订号>
第一部分在系统的重要发布或重大阶段会进行改变,比如每几个月一次。下面两部分是由开发者控制的。子版本改变意味着数据库中加入了破坏性的改动(例如新的必需字段),这使得“旧的”应用程序与新的数据库架构不再兼容。修订号则是每次非破坏性的变动发生时(例如新的索引、新表、新的可选字段等等)进行递增的。每次上级版本号更新,下级版本号默认清零
3. 更新脚本:
由开发者进行编写的数据库更新脚本,此脚本中包含多个更新数据库的语句,使用英文分号分隔(标准的数据库语句写法),不必特意使用事务脚本,java程序会将每一个更新脚本文件当做一个事务来处理。添加注释需要使用“ /注释/ ”方式来写
4. 更新脚本文件命名规范:
为文件名称使用以下格式
<前缀>_<数据库版本表中的当前版本号>_<目标版本号>_<有关升级的其它信息>.sql,
例如:report_1.0.1_1.0.2_rename_column.sql
目前,前缀我们默认使用产品名称来描述,用来和每个项目中配置文件中的product_name对应
5. 记录应用升级脚本的历史,db_version_history表
Column name | Column type | Nullable | 描述 | |
---|---|---|---|---|
id | int(11) | Not null | 自增长ID | |
product_name | varchar(50) | Not null | 产品名称 | |
version | varchar(50) | Not null | 最新版本号 | |
update_by | varchar(50) | Not null | 更新人 | |
update_on | datetime | Not null | 更新时间 | |
reason | varchar(1000) | Not null | 更新原因 |
6. db_schema_version表,这张表存储的是当前所有应用实例的数据库版本信息(应用启动会检查版本与此表中的版本是否一致)
Column name | Column type | Nullable | 描述 |
---|---|---|---|
id | int(11) | Not null | 自增长ID |
version | varchar(50) | Not null | 最新版本号 |
product_name | varchar(50) | Not null | 产品名称 |
desc | varchar(1000) | Not null | 描述 |
update_on | datetime | Not null | 更新时间 |
update_by | varchar(50) | Not null | 更新人 |
full_schema | varchar(50) | Not null | 完整的建表语句文件名 |
by 刘迎光@萤火虫工作室
OpenBI交流群:495266201
MicroService 微服务交流群:217722918
mail: liuyg#liuyingguang.cn
博主首页(==防止爬虫==):http://blog.liuyingguang.cn
OpenBI问答社区:http://www.openbi.tk