脚本之家 服务器常用软件
快捷导航
您的位置：首页 → 软件编程 → java → Spring Boot 管理数据库版本

详解Spring Boot中使用Flyway来管理数据库版本

 更新时间：2018年01月03日 09:09:28   作者：翟永超  
这篇文章主要介绍了详解Spring Boot中使用Flyway来管理数据库版本，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧

如果没有读过上面内容的读者，有兴趣的可以一阅。在上面的使用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做系统开发的个人或团队在数据库的版本控制上做的更好提供一些思路。至于更深入的应用还请读者自行翻阅官方文档参考和学习。

本文代码:Github：https://github.com/dyc87112/SpringBoot-Learning/

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

相关文章

  • 基于java类路径classpath和包的实例讲解

    基于java类路径classpath和包的实例讲解

    下面小编就为大家分享一篇基于java类路径classpath和包的实例讲解，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
    2018-01-01
  • Spring Boot快速过滤出一次请求的所有日志

    Spring Boot快速过滤出一次请求的所有日志

    这篇文章主要介绍了Spring Boot快速过滤出一次请求的所有日志,本文讲述了如何使用MDC工具来快速过滤一次请求的所有日志，并通过装饰器模式使得MDC工具在异步线程里也能生效，需要的朋友可以参考下
    2022-11-11
  • SpringBoot对接Spark过程详解

    SpringBoot对接Spark过程详解

    这篇文章主要介绍SpringBoot接入Spark的方法的相关知识，小编通过实际案例向大家展示操作过程，操作方法简单快捷，实用性强，希望能帮助大家解决问题
    2023-02-02
  • Jemalloc优化MySQL和Nginx

    Jemalloc优化MySQL和Nginx

    这篇文章主要介绍了Jemalloc优化MySQL和Nginx的相关资料,需要的朋友可以参考下
    2016-01-01
  • mybatis中foreach报错：_frch_item_0 not found的解决方法

    mybatis中foreach报错：_frch_item_0 not found的解决方法

    这篇文章主要给大家介绍了mybatis中foreach报错：_frch_item_0 not found的解决方法，文章通过示例代码介绍了详细的解决方法，对大家具有一定的参考学习价值，需要的朋友们下面来一起看看吧。
    2017-06-06
  • Java详细分析讲解HashMap

    Java详细分析讲解HashMap

    在java开发中，HashMap是最常用、最常见的集合容器类之一，下面一起温故一下，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
    2022-06-06
  • Java8新特性之字符串去重介绍

    Java8新特性之字符串去重介绍

    这篇文章主要介绍了Java8新特性之字符串去重介绍,新的字符串去重特性可以帮助减少应用中String对象的内存占用，目前该特性只适用于G1垃圾收集器，并且默认不被开启,需要的朋友可以参考下
    2014-09-09
  • Spring框架中@AliasFor注解详细说明

    Spring框架中@AliasFor注解详细说明

    这篇文章主要给大家介绍了关于Spring框架中@AliasFor注解详细说明的相关资料,@AliasFor是Spring Framework中的一个注解,它用于指定注解属性之间的别名关系,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2024-02-02
  • Java模板动态生成word文件的方法步骤

    Java模板动态生成word文件的方法步骤

    最近项目中需要根据模板生成word文档，模板文件也是word文档。本文使用使用freemarker模板生成word文件，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
    2021-07-07
  • MyBatis中Mapper的注入问题详解

    MyBatis中Mapper的注入问题详解

    这篇文章主要介绍了MyBatis中Mapper的注入问题,我知道在 SpringBoot 体系中，MyBatis 对 Mapper 的注入常见的方式有 2 种，具体哪两种方法跟随小编一起看看吧
    2021-09-09

最新评论