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：

解决方法可以参考这篇文章