一.Flyway简介

Flyway是一款数据库迁移（migration）工具。简单点说，就是在你部署应用的时候，帮你执行数据库脚本的工具。Flyway支持SQL和Java两种类型的脚本，你可以将脚本打包到应用程序中，在应用程序启动时，由Flyway来管理这些脚本的执行，这些脚本被Flyway称之为migration。

二.使用

一.导入依赖

<!-- flyway-->
<dependency>
   <groupId>org.flywaydb</groupId>
   <artifactId>flyway-core</artifactId>
   <version>5.0.7</version>
</dependency>

二.配置文件

flyway.locations: classpath:db/migration

spring boot 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.user迁移数据库的用户名

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.validate-on-migrate迁移时是否校验，默认为true

spring:
  # flyway 配置
  flyway:
    # 如果启动的时候需要flyway管理sql脚本的话，将enabled设置为true
    enabled: true
    # 如果数据库不是空表，需要设置成 true，否则启动报错
    baseline-on-migrate: true
    # 表示是否禁用要清除已有库下的表
    clean-disabled: true
    # 验证错误时 是否自动清除数据库 高危操作!
    clean-on-validation-error: false
    # 基准版本号
    baseline-version: 1.0.0
    # flyway 数据库配置
    url: ${spring.datasource.druid.master.url}
    user: ${spring.datasource.druid.master.username}
    password: ${spring.datasource.druid.master.password}
    driver-class-name: ${spring.datasource.driverClassName}

命令	描述
Baseline	初始化flyway_schema_history表，并插入一条原始verion=1
Info	打印所有的迁移的信息以及状态
Validate	迁移之前进行验证
Migrate	应用所有的迁移到最新版本，它会在你的DB中新建个表flyway_schema_history来存放每次升级的版本信息
Repair	移除所有失败的迁移（升级），重置校验和删除flyway_schema_history失败记录
Clean	清除目标库所有表及数据，谨慎！！！
Undo	用于撤销具有相同版本的版本化迁移带来的影响。但是该回滚过于粗暴，过于机械化，一般不推荐使用。一般建议使用 Versioned 模式来解决

三.文件版本管理

在db/migration目录为默认目录，创建需要更新的SQL，命名规则为：

命名解说：

• 前缀：V用于版本化、U用于撤销、R可重复迁移
• 版本：带点或下划线的版本根据需要分开，可重复迁移不需要
• 分隔符：__默认两个下划线
• 说明：sql描述
• 后缀：.sql

创建后直接启动项目发布

四.flyway_schema_history表

注意：已发布的版本文件sql，不能去更改，除非保持表中checksum数量一致。