官方文档:Documentation - Flyway by Redgate • Database Migrations Made Easy.https://flywaydb.org/documentation/
Flyway是一款开源的数据库版本管理工具,它更倾向于规约优于配置的方式。
能够实现数据库表自动同步更新,减少人工管理sql的压力,减少人为操作,降低人工时间成本,极大的提升代码的部署、测试的自动化流转效率,更快的发现开发过程中的问题,进而可以提升代码质量和效率。
1. pom.xml引入jar
org.flywaydb
flyway-core
5.2.4
2.在application.properties添加Flyway配置:
spring:
# 数据库连接配置
datasource:
driver-class-name: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://127.0.0.1:3306/flyway?characterEncoding=utf-8&useSSL=false&serverTimezone=GMT%2B8
username: xxx
password: xxx
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
3.根据在配置文件的脚本存放路径的配置,在resource目录下建立文件夹db/migration
版本号命名规则:flyway 执行的 SQL 脚本必须遵循一种命名规则,V
注意:
V 开头的只会执行一次,下次项目启动不会执行,也不可以修改原始文件,否则项目启动会报错,如果需要对 V 开头的脚本做修改,如果有个 SQL 脚本需要在每次启动的时候都执行,那么将 V 改为 R 开头即可。即随着项目启动,V开头只执行一次,R开头可以重复执行。
使用flyway创建表后,就不要再去数据库手动改这张表的结构了,一切表的结构改动都用flyway,否则会影响修改记录,导致项目报错
上述两种情况的解决方案:找到flyway_schema_history表,删除对应的记录即可。
4.项目启动后,flyway_schema_history该表记录版本号的sql执行记录
sql中的insert语句已经插入到对应数据库表中。