Spring Boot中使用Flyway来管理数据库版本

摘要: 工作以来，项目组都是通过flyway来管理数据库版本的，在之前的项目组，由于迭代开发安排的比较好，数据库版本通过flyway管理的顺风顺水，但是来了新的部门之后，发现单任务比较多。很容易就把flyway中数据库脚本的版本号搞乱了。很头疼这个问题。今天发现了Flyway一个配置参数（flyway.out-of-order是否允许无序的迁移，默认false.），把这个参数使用好，然后再变换一下版本号的规则就能够很好的解决这个问题。

我们采用的是敏捷开发，使用git管理代码。我们的环境有dev-testing-release-maste。我们的flyway的版本号也是按照1，2，3···逐渐递增的。这样就存在一个问题，如果我dev的版本号是20，testing是19，master是18.但是如果现在有一个单任务需要上一个脚本，编号就遇到困难了。如果是编成19，那么testing和dev的号就需要依次往后迁移一个，太麻烦。并且几乎每个迭代都会有单任务上。这样就太费劲了。或者说是直接把dev和testing的脚本也跟着上到master，然后新的脚本按照21编号。这样也是不合适的。一时之间想不到有什么好的办法。这个时候就有同事出来说了，“这是什么玩意儿，直接废掉，不用了。”

今天查资料发现flyway里面其实有个参数 flyway.out-of-order是否允许无序的迁移，默认false.如果把这个参数设置成true的话，那么像上面的问题，我直接把master上面的版本号设置成21就可以了。等到dev和testing上面的脚本走到master上面的时候，也还会把19和20都执行掉。这样就好了。问题就解决了。这样的话，还存在一个问题。就是我要上一个脚本的时候，需要把dev，testing，release，master上面都需要看一遍，然后确定版本号。现在，我们直接把版本号使用时间戳来表示。这样就方便了，也不用再去看所有环境的编号到什么地方了。使用时间戳作为版本号，肯定不会有重复。

这样一来，就把问题给解决掉了。之前还是没有使用好这个工具。

我们之前已经使用了一段时间flyway了，所以采用新的规则之后，重新开了一个存放脚本的地址，过度的说明：

1. 在application.yml配置文件中的flyway下面增加

locations: db/migration/V1,db/migration/V2（两个路径之间不能有空格）
out-of-order: true

2. 在数据库db.migration下面增加V2目录。然后新的脚本就开始往V2路径下面放。脚本命名规则：V时间戳(年2018月01日10时09分44)__描述.sql [V201801100944__描述.sql]。版本号使用确定到“年月日时分”的时间戳来确定。



把flyway里面的配置也加一下

flyway.baseline-description对执行迁移时基准版本的描述.
flyway.baseline-on-migrate当迁移时发现目标schema非空，而且带有没有元数据的表时，是否自动执行基准迁移，默认false.
flyway.baseline-version开始执行基准迁移时对现有的schema的版本打标签，默认值为1.
flyway.check-location检查迁移脚本的位置是否存在，默认false.
flyway.clean-on-validation-error当发现校验错误时是否自动调用clean，默认false.
flyway.enabled是否开启flywary，默认true.
flyway.encoding设置迁移时的编码，默认UTF-8.
flyway.ignore-failed-future-migration当读取元数据表时是否忽略错误的迁移，默认false.
flyway.init-sqls当初始化好连接时要执行的SQL.
flyway.locations迁移脚本的位置，默认db/migration.
flyway.out-of-order是否允许无序的迁移，默认false.
flyway.password目标数据库的密码.
flyway.placeholder-prefix设置每个placeholder的前缀，默认${.
flyway.placeholder-replacementplaceholders是否要被替换，默认true.
flyway.placeholder-suffix设置每个placeholder的后缀，默认}.
flyway.placeholders.[placeholder name]设置placeholder的value
flyway.schemas设定需要flywary迁移的schema，大小写敏感，默认为连接默认的schema.
flyway.sql-migration-prefix迁移文件的前缀，默认为V.
flyway.sql-migration-separator迁移脚本的文件名分隔符，默认__
flyway.sql-migration-suffix迁移脚本的后缀，默认为.sql
flyway.tableflyway使用的元数据表名，默认为schema_version
flyway.target迁移时使用的目标版本，默认为latest version
flyway.url迁移时使用的JDBC URL，如果没有指定的话，将使用配置的主数据源
flyway.user迁移数据库的用户名
flyway.validate-on-migrate迁移时是否校验，默认为true.

参考博文：spring boot flyway 配置说明