NoSQLSpring Boot中选用Flyway来管理数据库版本

久违了的Spring
Boot体系,前日忙里偷闲更新一篇。二〇一八年写过不少篇关于数据访问的篇章了,比如下边这一个:

虽然没有读过地方内容的读者,有趣味的能够一阅。在地点的使用JdbcTemplate一文中,重要透过spring提供的JdbcTemplate实现对用户表的增删改查操作。在落实这么些事例的时候,大家事先在MySQL中创建了用户表。创设表的历程我们在其实开发系列的时候会时常应用,然则一向有一个问题存在,由于一个系统的顺序版本通过git拿到了很好的版本控制,而数据库结构并不曾,尽管我们经过Git举办了话语的版本化,那么在挨家挨户环境的数据库中如何办好版本管理吗?下边我们就通过本文来读书一下在Spring
Boot中什么行使Flyway来管理数据库的版本。

Flyway简介

Flyway是一个简便开源数据库版本控制器(约定大于配置),紧要提供migrate、clean、info、validate、baseline、repair等一声令下。它襄助SQL(PL/SQL、T-SQL)形式和Java模式,辅助命令行客户端等,还提供一多元的插件协理(Maven、Gradle、SBT、ANT等)。

官方网站:https://flywaydb.org/

正文对于Flyway的我效益不做过多的介绍,读者能够经过翻阅官方文档或拔取搜索引擎得到更多材料。下面我们具体说说在Spring
Boot应用中的应用,咋样使用Flyway来创制数据库以及社团不雷同的检查。

动手试一试

下边我们得以经过对使用JdbcTemplate一文中的例子举行加工完成。读者也得以拿任何一个与数据访问相关的工程来做如下内容的尝试:

  • 第一步,在pom.xml中增加flyway的依赖:

<dependency>
    <groupId>org.flywaydb</groupId>
    <artifactId>flyway-core</artifactId>
    <version>5.0.3</version>
</dependency>
  • 第二步,按Flyway的正规化创制版本化的SQL脚本。
    • 在工程的src/main/resources目录下创制db目录
    • db目录下开创版本化的SQL脚本V1__Base_version.sql

DROP TABLE IF EXISTS user ;
CREATE TABLE `user` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主键',
  `name` varchar(20) NOT NULL COMMENT '姓名',
  `age` int(5) DEFAULT NULL COMMENT '年龄',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
  • 第三步,在application.properties文件中配备Flyway要加载的SQL脚本地方。按第二步创立的结果配置如下:

flyway.locations=classpath:/db
  • 第四步,执行单元测试ApplicationTests,此时我们在日记中得以见见如下消息:

INFO 82441 --- [main] o.f.core.internal.util.VersionPrinter    : Flyway Community Edition 5.0.3 by Boxfuse
INFO 82441 --- [main] o.f.c.internal.database.DatabaseFactory  : Database: jdbc:mysql://localhost:3306/test (MySQL 5.7)
INFO 82441 --- [main] o.f.core.internal.command.DbValidate     : Successfully validated 1 migration (execution time 00:00.022s)
INFO 82441 --- [main] o.f.c.i.s.JdbcTableSchemaHistory         : Creating Schema History table: `test`.`flyway_schema_history`
INFO 82441 --- [main] o.f.core.internal.command.DbMigrate      : Current version of schema `test`: << Empty Schema >>
INFO 82441 --- [main] o.f.core.internal.command.DbMigrate      : Migrating schema `test` to version 1 - Base version
WARN 82441 --- [main] o.f.core.internal.sqlscript.SqlScript    : DB: Unknown table 'test.user' (SQL State: 42S02 - Error Code: 1051)
INFO 82441 --- [main] o.f.core.internal.command.DbMigrate      : Successfully applied 1 migration to schema `test` (execution time 00:00.128s)

Flyway监测到需要周转版本脚本来初始化数据库,由此推行了V1__Base_version.sql剧本,从而开创了user表,这才得以让一多元单元测试(对user表的CRUD操作)通过。

  • 第五步,我们可以延续再举行一下单元测试,此时我们会意识日志输出与事先不同:

INFO 83150 --- [main] o.f.core.internal.util.VersionPrinter    : Flyway Community Edition 5.0.3 by Boxfuse
INFO 83150 --- [main] o.f.c.internal.database.DatabaseFactory  : Database: jdbc:mysql://localhost:3306/test (MySQL 5.7)
INFO 83150 --- [main] o.f.core.internal.command.DbValidate     : Successfully validated 1 migration (execution time 00:00.031s)
INFO 83150 --- [main] o.f.core.internal.command.DbMigrate      : Current version of schema `test`: 1
INFO 83150 --- [main] o.f.core.internal.command.DbMigrate      : Schema `test` is up to date. No migration necessary.

由于在第四步的时候,开始化脚本早已执行过,所以这一次实施就从未有过再去实施V1__Base_version.sql脚本来重建user表。

  • 第六步,咱们得以品味修改一下V1__Base_version.sql本子中的name字段长度,然后在运行一下单元测试,此时我们得以获取如下错误:

ERROR 83791 --- [main] o.s.boot.SpringApplication               : Application startup failed

org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'flywayInitializer' defined in class path resource [org/springframework/boot/autoconfigure/flyway/FlywayAutoConfiguration$FlywayConfiguration.class]: Invocation of init method failed; nested exception is org.flywaydb.core.api.FlywayException: Validate failed: Migration checksum mismatch for migration version 1
-> Applied to database : 466264992
-> Resolved locally    : -270269434

出于开始化脚本的更改,Flyway校验失利,认为当下的V1__Base_version.sql本子与上一次进行的情节见仁见智,指示报错并终止程序,以免导致更严重的数据结构破坏。

总结

到这里截止,本文的始末告一段落。由于博文篇幅问题,对于Flyway更细节的利用没有说的太多,本文紧要用作打击砖,帮助和指引正在采用Spring
Boot做系统开发的个人或协会在数据库的版本控制上做的更好提供部分思路。至于更尖锐的采纳还请读者自行翻阅官方文档参考和学习。

本文代码

可以通过下边多少个仓库中查阅Chapter3-2-9索引:

原文:Spring
Boot中动用Flyway来保管数据库版本

网站地图xml地图