数据库版本管理方案（正式版V0.0.2）

概述

软件开发过程中，往往会遇到版本管理问题，也常常会遇到服务多版本管理问题，也常常会遇到不同版本的服务之间，数据库字段不同、建表语句不同的问题，那么如何在不同版本间进行平滑升级，那么就需要有一系列的规范（暂不涉及回退方案）：

升级步骤

自动化管理，由程序在启动前操作：

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