Spring Boot 集成 Flyway,数据库也能做版本控制,太牛了!

运维 数据库运维
我们都知道,Git/ SVN 是代码界的版本控制工具,那么,Flyway 就是一款数据库界的版本控制工具,它可以记录数据库的变化记录。

 [[408140]]

一、Flyway 是什么?

我们都知道,Git/ SVN 是代码界的版本控制工具,那么,Flyway 就是一款数据库界的版本控制工具,它可以记录数据库的变化记录。

可能很多公司都是通过人工去维护、同步数据库脚本,但经常会遇到疏忽而遗漏的情况,举个简单的例子:

我们在开发环境对某个表新增了一个字段,而提交测试时却忘了提交该 SQL 脚本,导致出现 bug 而测试中断,从而影响开发、测试的工作效率。

有了 Flyway,我们可以按版本约定,统一管理所有的 SQL 脚本变更,在所有环境自动同步数据库,而无需人为手工控制,再也不用担心因数据库不同步而导致的各种环境问题。

官网:https://flywaydb.org/

支持的数据库:

支持的运行方式:

支持的 7 个命令:

  • Migrate(迁移)
  • Clean(清理所有配置的对象)
  • Info(显示迁移状态和细节)
  • Validate(验证迁移规则)
  • Undo(撤消最近的迁移)
  • Baseline(建立基线)
  • Repair(修复迁移历史表)

二、Spring Boot 集成 Flyway

Flyway 有社区开源免费版本和商业版本,本文以开源社区免费版,以及 Java API 的运行方式为示例进行演示下 Flyway Migrate 功能。

1、引入依赖

Flyway 几乎是零依赖,最低的要求是:

  • JDK 1.7+
  • Jdbc Driver

Spring Boot 基础教程就不介绍了,栈长之前写过很多,不会的关注公众号:Java技术栈,在后台回复:boot,历史 Spring Boot 实战教程我都整理好了。

本文演示环境:

  • JDK 1.8
  • Spring Boot 2.5.0
  • MySQL 8.0
  • IntelliJ IDEA 2021.1

这里仅展示 Spring Boot 之外的核心依赖:

  1. <dependencies> 
  2.     <dependency> 
  3.         <groupId>org.springframework.boot</groupId> 
  4.         <artifactId>spring-boot-starter-data-jdbc</artifactId> 
  5.     </dependency> 
  6.     <dependency> 
  7.         <groupId>mysql</groupId> 
  8.         <artifactId>mysql-connector-java</artifactId> 
  9.         <version>8.0.21</version> 
  10.     </dependency> 
  11.     <dependency> 
  12.         <groupId>org.flywaydb</groupId> 
  13.         <artifactId>flyway-core</artifactId> 
  14.         <version>7.10.0</version> 
  15.     </dependency> 
  16. </dependencies> 

 

 

2、添加配置

Spring Boot 默认提供了对 Flyway 的自动配置:

org.springframework.boot.autoconfigure.flyway.FlywayAutoConfiguration

所以,Spring Boot 项目,我们仅仅只要提供对应的配置参数即可:

  1. spring: 
  2.   datasource: 
  3.     driver-class-name: com.mysql.cj.jdbc.Driver 
  4.     url: jdbc:mysql://localhost:3306/flyway 
  5.     username: flyway 
  6.     password: 12345678 
  7.   flyway: 
  8.     locations: 
  9.       - classpath:flyway 
  10.     table: t_flyway_history 

版本注意:

Spring Boot 2.5 及以上版本,如果使用了 spring.flyway.url 进行定义,同时需要加上 username/ password 进行认证。

如果是第一次使用 Flyway,需要在 resources 目录下创建配置文件中指定的 Flyway 迁移目录:resources/flyway。

Flyway 也是约定大于配置的思想,以上 Flyway 的相关配置都可以不用写,可以说是零配置,它们都有默认值:

  • spring.flyway.locations: classpath:db/migration,用于扫描的迁移脚本目录
  • spring.flyway.table: flyway_schema_history,用于记录所有的版本变化记录

更多 Flyway 的参数配置可以参考这个类:

org.springframework.boot.autoconfigure.flyway.FlywayProperties

另外,最好是创建一套 Flyway 专门的数据库表和用户,和业务表、用户分开,权利最小化。

三、迁移实战

1、创建迁移脚本

然后在该目录下创建迁移脚本,迁移脚本文件命名规则是:

  1. V__.sql 

注意:版本号后面是两个下划线。

如栈长我第一次创建三个迁移脚本:

  • V1.0.0__create_javastack.sql
  • V1.0.1__insert_javastack.sql
  • V1.0.2__update_javastack.sql

首先创建一个表,然后插入几条记录,再更新记录,具体的 SQL 脚本内容就不贴上来了,完整的示例代码已提交 Github:

https://github.com/javastacks/spring-boot-best-practice

OK,Spring Boot 集成 Flyway 及相关的脚本都弄完了,可以说是不能再简单了,我们启动系统验证下脚本有没有执行。

1)首次启动

从启动日志可以看出,已经迁移了 3 个脚本,并且将当前版本更新到了 v1.0.2:

查看数据库,Flyway 历史表和业务表也都已经创建:

可以看出历史表记录了 3 个脚本的迁移详细记录,业务表的数据也已经插入并得到更新:

2)不修改再次启动

在不修改任何代码的情况下再次启动:

成功验证了 3 个迁移脚本,打印了当前的版本号,但并没有进行迁移,为什么?

因为这三个脚本都执行过迁移了,主要是版本号都小于等于当前版本号:1.0.2,所以不会进行迁移。

3)修改再次启动

我们再新增两个 SQL 脚本:

  • V1.0.3__alter_javastack.sql
  • V1.0.4__update_javastack.sql

首先新增两个字段:note 和 time,然后再进行对应的数据更新。

我们再次启动下:

成功迁移,当前版本来到了 v1.0.4。

查看数据库:

note 和 time 字段已经创建,并得到更新。

2、创建重复迁移脚本

从上面的例子我们知道,只要目录下的 SQL 脚本版本号大于当前版本号才会执行迁移,并且脚本都是一次性执行迁移的,如何做到可重复迁移呢?

Flyway 支持可重复迁移脚本,可重复迁移脚本文件命名规则是:

  1. R__.sql 

R(Repeated),即:可重复的。

这里我创建一个更新 note 和 time 字段的迁移脚本:

  • R__update_javastack.sql

1)首次启动

我们再次启动下:

从以上截图可以看到,重复迁移脚本也已经成功执行了。

2)不修改再次启动

如何确定能否重复执行迁移呢?

我们不修改任何代码再次启动下:

显示没有迁移的必要!!

那是因为我们没有对重复迁移脚本做任何的修改,所以系统不会迁移!

3)修改再次启动

我们再次改下脚本,把 note 后面加一个 ok,再次启动下:

脚本经过修改后再次迁移成功了,说明可重复迁移脚本也需要经过改动才能再次进行迁移,Flyway 会进行脚本对比。

最后贴一下迁移脚本目录:

这里我放到一个目录进行演示,实际开发中可以放到多个目录中区分维护。

四、迁移流程

OK,我们来梳理下迁移流程:

1)Flyway 会扫描配置的脚本目录下的脚本文件;

2)如果历史记录表不存在,则新建历史记录表;

3)如果是一次性执行脚本(V),按版本号从小到大执行迁移脚本,与当前历史表中的版本号做对比,大于当前版本号的脚本才会被执行迁移;

4)如果是可重复执行脚本(R),检查脚本是否有变动,有变动的可重复脚本才会被执行迁移;

Flyway Migrate 迁移流程图:

来源官网

另外,我们也可以手动删除迁移历史表中的迁移记录,这样也可以达到让一次性脚本再次执行的目的,但不建议在生产环境上进行使用。

五、总结

使用 Flyway 可以很方便的处理数据库表结果、数据的版本迁移,使用简单、自动化,大大提高生产力,再也不需要手工在控制台进行,那样更容易出错或者遗漏,毕竟人都是会经常犯错的。

本文使用的是 Java API 的方式,在项目启动时进行迁移,另外还有其他 3 种方式,文前有介绍,大家根据实际需要进行应用。

本文只是抛砖引玉,只介绍了 Flyway 中的 Migrate(迁移)环节,也是 Flyway 最主要的环节,另外还有其他 6 个环节,后续栈长在时间再进行分享,请陆续关注公众号Java技术栈,公众号第一时间推送。

本文完整示例代码已上传 Github:

https://github.com/javastacks/spring-boot-best-practice

更多细节可以参考官方文档:

https://flywaydb.org/documentation/

最后,你们有使用 Flyway 或者相关工具吗?欢迎分享使用经验~

本文转载自微信公众号「Java技术栈」,可以通过以下二维码关注。转载本文请联系Java技术栈公众号。

 

责任编辑:武晓燕 来源: Java技术栈
相关推荐

2017-12-27 15:16:35

Spring BootFlyway数据库

2021-03-09 17:11:09

数据库脚手架开发

2019-10-30 11:28:56

Javaflyway数据库

2020-08-13 07:42:15

数据库Flyway代码

2021-08-02 19:18:32

Redis缓存高并发

2021-01-19 05:27:44

HTTPSECDHE算法

2019-05-31 08:23:00

Oracle数据库云渡劫

2011-08-17 10:11:34

MySQL数据库MVCC

2017-12-01 06:02:14

耦合数据库CA

2023-04-28 15:15:39

数据库JPA

2017-11-03 17:05:11

开源

2021-07-15 11:31:22

递归匹配参数

2021-05-17 08:00:00

数据库工具Flyway

2020-04-21 23:14:08

数据并发控制

2009-06-18 16:29:00

牛新庄数据库

2021-03-05 09:38:53

项目数据库系统

2024-01-07 18:02:21

数据库分片副本

2024-01-10 08:17:50

HikariCP数据库Spring

2021-08-04 09:00:53

Python数据库Python基础

2021-08-02 09:01:29

PythonMySQL 数据库
点赞
收藏

51CTO技术栈公众号