数据库版本管理：Flyway探索与实践

引言：
若是你是一个独立开发者或者不须要维护多个系统，那么维护数据库版本并不复杂。可是若是你的团队正在快速迭代或者同时开发多个功能，在多个环境版本并行，在多个生产服务器上部署你的服务，那么数据库的管理将变成一件麻烦事。如何更新全部的数据库，并维护好全部的更新记录，把多我的的操做合并起来带来了挑战。
​咱们团队在开发的过程当中也有一样的困扰。这篇文章将介绍咱们团队是如何经过Flyway将这些问题逐一解决。

Flyway基本概念

什么是flyway，为何要用flyway

flyway是数据库版本控制管理工具，用于进行sql脚本版本控制和数据库迁移。

之前咱们的数据库更改都是经过在某一个文件夹中添加一条sql文件，而后手动执行的。

这样在一个新环境进行数据库迁移时就会衍生出一系列的问题：

须要人工手动一条一条地执行这些脚本
有些时候，不恰当的命名会使这些sql脚本的执行顺序变得难以肯定
若是手动执行时，脚本执行一半发生了一些其余的事情中断了执行人的操做，那么在下次执行时怎么知道当前数据库的sql执行到哪里了，哪些成功执行了哪些没有执行成功

因此咱们迫切地须要一个工具来处理这些问题——flyway

flyway是如何工做的

flyway会在项目启动时，完成创建数据库链接池后自动执行以下操做：

1.若是数据库是一个空的数据库，flyway会建立一个名为flyway_schema_history的sql执行记录表，若是不是一个空的数据库，flyway会跳过这一步
2.flyway会扫描项目指定路径下（spring项目默认在classpath:db/migration下）的全部sql脚本，并和flyway_schema_history表下全部的脚本记录进行比对，全部版本号小于或者等于当前版本的脚本将被忽略。可是flyway会计算这些脚本的校验和，而后和数据库记录执行过的脚本比较，若是他们校验和不一致就会报错并中止项目执行
3.其他的全部脚本将会按照版本号进行排序，而后逐个执行

补充：
若是一条sql脚本执行出错，flyway会在数据库中留下一条执行出错的记录，而且这条脚本的执行将被自动回滚。版本号高于出错脚本的待执行脚本将都不会被执行，也不会留下记录

WARNING: 若是flyway记录表中有出错记录，那么flyway将没法执行，请手动更改脚本错误，并手动删除记录表中的这条出错记录从新启动项目。

如何使用flyway

前提：

假设数据库链接池等相关配置已经设置完毕，若是没有能够参考Alibaba Druid配置

1.导包

2.添加配置

3.创建sql脚本

默认配置下flyway的脚本在resources/db/migration下

命名格式为V{describe}.sql

4.执行项目便可

flyway常见问题

如何中途集成flyway

问题描述

flyway集成的最佳时期是项目刚开始时，将数据库初始化脚本等全权交由flyway来管理。
其次就是在项目起步不久，项目的sql脚本还尚且有序，且清楚当前脚本执行到哪里时。

幸运的是，咱们当时集成flyway时就处于第二种阶段。那么到底如何集成呢，有什么该注意的呢

解决方案

1.按照如何使用下的第三条给脚本命名
2.在数据库中执行以下脚本创建flyway记录表(这里用的数据库是mysql 8.0)

3.向flyway记录表插入手动插入已执行过sql脚本的记录

4.处理flyway的校验和

如下两种方法选择一种便可

手动关闭flyway的checksum校验，只须要在配置中添加这么一条便可：

spring.flyway.validate-on-migrate=false

使用flyway提供的cli工具，执行repair命令

详细下载和使用请参考下载和使用Command-line tool

在当前一周alpha，下一周上线的开发模式下如何正确使用flyway

问题描述

考虑如下流程：

1.咱们这周新切出的alpha分支即fat环境 flyway的版本为V10，master分支（dev环境）也是V10
2.以后master分支开发了新功能涉及到修改数据库，版本号变为了V11
3.fat环境出现了bug，须要修改数据库，建立了一个版本号为V12的脚本，修改也整合到了master上

因而如今dev环境的脚本记录是V10, V11, V12; fat环境的脚本记录是V10，V12

等下周master又切出新的alpha分支，虽然这个分支的代码携带了V10, V11, V12,三个脚本，可是因为fat数据库的最新脚本记录是V12，因此V11这个脚本将永远不会被执行

解决方案

我想到的方法有三种：

1.防范于未然，通常状况下，fat出现须要修改数据库的bug在dev环境下本身单元测试的时候就应该能发现。不该该在fat环境被测试测出来了才发现这个问题。
2.新建fat环境的sql执行脚本时，把master分支中新脚本版本号以前可是不在alpha版本的脚本所有copy过来执行。

这种方法适用于肯定copy过来的其余脚本不会影响到fat正常运行的状况

3.将新脚本版本号提早，提早到切出当前alpha分支时的脚本版本号以后。

WARNING: 使用这个方法时要注意，dev环境须要手动跑这条新脚本，并在flyway执行记录数据库中手动插入这条执行记录

Reference

flyway官方网站

加入咱们

点击应聘Java开发工程师
点击应聘后端开发工程师
点击应聘前端开发工程师