SpringBoot集成Flyway进行数据库版本迁移管理的步骤
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_schemaFlyway通过创建表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:db2.添加初始化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的资料请关注好吧啦网其它相关文章!
相关文章: