SpringBoot集成Flyway进行数据库版本迁移管理的步骤

 更新时间:2021年03月04日 09:15:30   作者:识1DD编程  
这篇文章主要介绍了SpringBoot集成Flyway进行数据库版本迁移管理的步骤,帮助大家更好的理解和学习使用SpringBoot框架,感兴趣的朋友可以了解下

Flyway简介

Flyway中的迁移(migrations)模式

Flyway对数据库的所有更改都称为 migrations(迁移) 。 migrations(迁移) 分为版本控制(Versioned)迁移与可重复(Repeatable)的迁移两种,
而版本控制又分为regular(常规)和undo(撤销)两种形式。

  • 版本控制迁移:具有版本号、描述和校验和,且版本是唯一的。描述用于简单记录迁移的内容,校验和用于检测意外更改。
  • 版本控制迁移通常用于以下用途:
  • 创建|更新|删除:表、索引、外键、枚举、UDT…
  • 数据更新

常规版本控制例子:

CREATE TABLE car (
 id INT NOT NULL PRIMARY KEY,
 license_plate VARCHAR NOT NULL,
 color VARCHAR NOT NULL
);
ALTER TABLE owner ADD driver_license_id VARCHAR;
INSERT INTO brand (name) VALUES ('DeLorean');

撤消(undo)迁移与常规版本迁移相反,但形式上看也是版本迁移的一种,具有相同版本的版本迁移影响。针对上例中的撤销迁移例子如下:

DELETE FROM brand WHERE name='DeLorean';
ALTER TABLE owner DROP driver_license_id;
DROP TABLE car;

可重复迁移:只有描述、校验和(checksum),没有版本号。可重复迁移不止执行一次,每次校验和(checksum)发生变更时就会被执行。
可重复迁移主要有以下两种用途:

  • (重新)创建视图/存储过程/函数/包/…
  • 批量插入参照数据

在一次迁移运行中,在所有版本迁移执行之后,可重复迁移在最后执行。可重复迁移按照它们描述的顺序执行。

Flyway迁移的命名模式如下:

  • 前缀:V指版本控制, U用于撤消和 R用于可重复迁移(可配置)
  • 版本:带点或下划线的版本可根据需要分隔任意多个部分(不适用于可重复的迁移)
  • 分隔符:两个下划线__(可配置)
  • 描述:下划线或空格分隔单词

Flaway的版本命名十分灵活,以下版本都是有效的迭代版本:

  • 1
  • 001
  • 5.2
  • 1.2.3.4.5.6.7.8.9
  • 205.68
  • 20130115113556
  • 2013.1.15.11.35.56
  • 2013.01.15.11.35.56

Flyway历史记录表flyway_history_schema

Flyway通过创建表flyway_history_schema来记录迁移,表中的主要字段如下:

Spring Boot集成示例

0.添加所需依赖

<dependencies>
 <dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-web</artifactId>
 </dependency>
 <!-- spring-boot-dependencies已包含了flyway的版本设置 -->
 <dependency>
  <groupId>org.flywaydb</groupId>
  <artifactId>flyway-core</artifactId>
 </dependency>
 <dependency>
  <groupId>mysql</groupId>
  <artifactId>mysql-connector-java</artifactId>
 </dependency>

1.application.yml配置数据库连接与sql脚本所在目录(不配则默认为classpath:db/migration)

spring:
 datasource:
 url: jdbc:mysql://localhost:3306/spring_boot_series?useUnicode=true&characterEncoding=UTF-8&zeroDateTimeBehavior=convertToNull&allowMultiQueries=true&serverTimezone=GMT
 username: root
 password: tiger
 driver-class-name: com.mysql.cj.jdbc.Driver
 # 自动读取spring.datasource配置进行迁移操作
 flyway:
 locations: classpath:db

2.添加初始化sql文件 V1.0__Base_DDL.sql 到配置目录下(前缀须以大写V为前缀,可通过sql-migration-prefix配置更改)

CREATE SCHEMA IF NOT EXISTS `spring_boot_series` DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
USE `spring_boot_series`;

-- -----------------------------------------------------
-- Table `spring_boot_series`.`user_base`
-- -----------------------------------------------------

CREATE TABLE IF NOT EXISTS `spring_boot_series`.`user_base`
(
 `id`   BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
 `nickname` VARCHAR(45)  NOT NULL DEFAULT '' COMMENT '昵称',
 `status`  VARCHAR(45)  NOT NULL,
 `sex`   TINYINT   NULL COMMENT '性别(MALE:1-男性,FEMALE:0-女性)',
 `mobile`  VARCHAR(13)  NOT NULL DEFAULT '' COMMENT '手机号码',
 `email`  VARCHAR(100) NOT NULL DEFAULT '' COMMENT '邮箱',
 `birthday` BIGINT   NOT NULL DEFAULT 0 COMMENT '生日',
 `create_time` DATETIME  NOT NULL DEFAULT CURRENT_TIMESTAMP,
 `update_time` DATETIME  NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
 PRIMARY KEY (`id`)
)
 ENGINE = InnoDB;


CREATE TABLE IF NOT EXISTS `spring_boot_series`.`user_auth`
(
 `id`   BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
 `uid`   BIGINT   NOT NULL,
 `identity_type` TINYINT   NOT NULL,
 `identifier` VARCHAR(50)  NOT NULL DEFAULT '',
 `certificate` VARCHAR(30)  NOT NULL DEFAULT '',
 `create_time` TIMESTAMP  NOT NULL DEFAULT CURRENT_TIMESTAMP,
 `update_time` TIMESTAMP  NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
 PRIMARY KEY (`id`),
 INDEX `idx_uid_certificate` (`uid` ASC, `certificate` ASC),
 INDEX `idx_type_identity` (`identity_type` ASC, `identifier` ASC)
)
 ENGINE = InnoDB
 COMMENT = '用户授权表';

3.添加版本文件

V1.0.1__Modify_user_birthday.sql:

alter table user_base modify birthday datetime null comment '生日';

V1.0.2__Modify_user_birthday.sql:

alter table user_base modify birthday timestamp null comment '生日';
alter table user_base add login_time timestamp null;

4.启动SpringBoot应用,以下为数据库为空SpringBoot应用运行时的执行输出

由于配置连接的数据库里没有任何表,所以SpringBoot应用运行时flyway会根据脚本进行数据库的初始化,执行的顺序会根据脚本版本号由低到高按顺序执行(1.0 -> 1.0.1 -> 1.0.2),每执行完一个版本脚本都会向记录表flyway_history_schema插入一条数据。
若添加了新的版本脚本,应用启动时flyway会根据脚本文件版本到记录表flyway_history_schema查询是否有对应的版本脚本被执行了,如果没有相应的版本脚本记录才会执行脚本。

参考

官网文档
示例地址

以上就是SpringBoot集成Flyway进行数据库版本迁移管理的步骤的详细内容,更多关于SpringBoot集成Flyway的资料请关注脚本之家其它相关文章!

相关文章

  • 详解mybatis #{}和${}的区别、传参、基本语法

    详解mybatis #{}和${}的区别、传参、基本语法

    这篇文章主要介绍了mybatis #{}和${}的区别、传参、基本语法,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-07-07
  • Java实现求数组最长子序列算法示例

    Java实现求数组最长子序列算法示例

    这篇文章主要介绍了Java实现求数组最长子序列算法,涉及java针对数组的递归遍历、判断相关操作技巧,需要的朋友可以参考下
    2018-07-07
  • 浅谈JVM之类的加载链接和初始化

    浅谈JVM之类的加载链接和初始化

    有了java class文件之后,为了让class文件转换成为JVM可以真正运行的结构,需要经历加载,链接和初始化的过程。这三个过程是怎么工作的呢?在本文中你将会找到答案。
    2021-06-06
  • spring boot+spring cache实现两级缓存(redis+caffeine)

    spring boot+spring cache实现两级缓存(redis+caffeine)

    这篇文章主要介绍了spring boot+spring cache实现两级缓存(redis+caffeine),小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-02-02
  • Springboot集成Kafka进行批量消费及踩坑点

    Springboot集成Kafka进行批量消费及踩坑点

    本文主要介绍了Springboot集成Kafka进行批量消费及踩坑点,文中通过示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-12-12
  • springboot实现基于aop的切面日志

    springboot实现基于aop的切面日志

    这篇文章主要为大家详细介绍了springboot实现基于aop的切面日志,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-09-09
  • 全面探究 Java 内部类

    全面探究 Java 内部类

    说起内部类这个词,想必很多人都不陌生,但是又会觉得不熟悉。原因是平时编写代码时可能用到的场景不多,用得最多的是在有事件监听的情况下,并且即使用到也很少去总结内部类的用法。今天我们就来一探究竟
    2021-09-09
  • Java中Date和LocalDate区别与介绍

    Java中Date和LocalDate区别与介绍

    本文主要介绍了Java中Date和LocalDate区别与介绍,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-07-07
  • Java Validation Api如何实现自定义注解

    Java Validation Api如何实现自定义注解

    这篇文章主要介绍了Java Validation Api如何实现自定义注解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-09-09
  • Response.AddHeader案例讲解

    Response.AddHeader案例讲解

    这篇文章主要介绍了Response.AddHeader案例讲解,本篇文章通过简要的案例,讲解了该项技术的了解与使用,以下就是详细内容,需要的朋友可以参考下
    2021-08-08

最新评论