flyway入门及使用
一、简单介绍
flyway开源的数据库版本管理工具
二、为什么要使用flyway
1.自己写的sql没有在全部环境执行
2.别人写的sql没有在全部环境执行
3.有人修改了已经执行过的SQL,期望再次执行
4.需要新增环境做数据迁移
三、flyway是如何工作
1.项目启动,数据库连接后,flyway自动运行。
2.初次使用,会创建一个flyway_schema_history 表,用于记录sql执行记录。
3.flyway会扫描项目路径下(默认classpath:db/migration)的所有脚本,和flyway_schema_history进行一一比对。如果项目中执行的sql脚本与数据库的记录不一致,flyway会报错并停止项目执行
4.如果校验通过,则根据表中的sql记录最大版本号,忽略所有版本号不大于该版本的脚本。再按照版本号从小到大,逐个执行其余脚本
四、配置
1.pom文件配置
flyway:
# 是否启用flyway
enabled: true
# 编码格式,默认UTF-8
encoding: UTF-8
# 迁移sql脚本文件存放路径,默认db/migration
locations: classpath:db/migration
# 迁移sql脚本文件名称的前缀,默认V
sql-migration-prefix: V
# 迁移sql脚本文件名称的分隔符,默认2个下划线__
sql-migration-separator: __
# 迁移sql脚本文件名称的后缀
sql-migration-suffixes: .sql
# 迁移时是否进行校验,默认true
validate-on-migrate: true
# 当迁移发现数据库非空且存在没有元数据的表时,自动执行基准迁移,新建schema_version表
baseline-on-migrate: true
2.文件命名规范
格式: V + 版本号 + __ (双下划线) + 描述.sql
注:
2.1 如果是一次性执行脚本(V),按版本号从小到大执行迁移脚本,与当前历史表中的版本号做对比,大于当前版本号的脚本才会被执行迁移;
2.2 如果是可重复执行脚本(R),检查脚本是否有变动,有变动的可重复脚本才会被执行迁移;
五、flyway_schema_history表字段详解
遇到的坑
1.运行flyway报错, MySQL 5.6 is no longer supported by Flyway Community Edition
大致意思:MySQL 5.6不支持Flyway社区版,只支持Flyway企业版,提出的解决方案是改成企业版或升级MySQL。
解决方法
1.把数据库升级为5.7版本以及以上的 就可以了 ,这种代价较大,为了用这个还得重装数据库;
2.更换flyway的jar包版本,用老版本即可,贴出依赖:
<dependency>
<groupId>org.flywaydb</groupId>
<artifactId>flyway-core</artifactId>
<version>5.2.1</version>
</dependency>
升级数据库版本代价太大,所以可以选择降低flyway版本
2.Flyway failed to initialize: none of the following migration scripts locations could be found:
解决方法可以参考这篇文章