SpringBoot集成Flyway进行数据库版本迁移管理的步骤
Flyway简介
Flyway中的迁移(migrations)模式
Flyway对数据库的所有更改都称为migrations(迁移)。migrations(迁移)分为版本控制(Versioned)迁移与可重复(Repeatable)的迁移两种,
而版本控制又分为regular(常规)和undo(撤销)两种形式。
- 版本控制迁移:具有版本号、描述和校验和,且版本是唯一的。描述用于简单记录迁移的内容,校验和用于检测意外更改。
- 版本控制迁移通常用于以下用途:
- 创建|更新|删除:表、索引、外键、枚举、UDT…
- 数据更新
常规版本控制例子:
CREATETABLEcar( idINTNOTNULLPRIMARYKEY, license_plateVARCHARNOTNULL, colorVARCHARNOTNULL ); ALTERTABLEownerADDdriver_license_idVARCHAR; INSERTINTObrand(name)VALUES('DeLorean');
撤消(undo)迁移与常规版本迁移相反,但形式上看也是版本迁移的一种,具有相同版本的版本迁移影响。针对上例中的撤销迁移例子如下:
DELETEFROMbrandWHEREname='DeLorean'; ALTERTABLEownerDROPdriver_license_id; DROPTABLEcar;
可重复迁移:只有描述、校验和(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来记录迁移,表中的主要字段如下:
SpringBoot集成示例
0.添加所需依赖
org.springframework.boot spring-boot-starter-web org.flywaydb flyway-core mysql mysql-connector-java
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配置更改)
CREATESCHEMAIFNOTEXISTS`spring_boot_series`DEFAULTCHARACTERSETutf8COLLATEutf8_general_ci; USE`spring_boot_series`; ------------------------------------------------------- --Table`spring_boot_series`.`user_base` ------------------------------------------------------- CREATETABLEIFNOTEXISTS`spring_boot_series`.`user_base` ( `id`BIGINTUNSIGNEDNOTNULLAUTO_INCREMENT, `nickname`VARCHAR(45)NOTNULLDEFAULT''COMMENT'昵称', `status`VARCHAR(45)NOTNULL, `sex`TINYINTNULLCOMMENT'性别(MALE:1-男性,FEMALE:0-女性)', `mobile`VARCHAR(13)NOTNULLDEFAULT''COMMENT'手机号码', `email`VARCHAR(100)NOTNULLDEFAULT''COMMENT'邮箱', `birthday`BIGINTNOTNULLDEFAULT0COMMENT'生日', `create_time`DATETIMENOTNULLDEFAULTCURRENT_TIMESTAMP, `update_time`DATETIMENOTNULLDEFAULTCURRENT_TIMESTAMPONUPDATECURRENT_TIMESTAMP, PRIMARYKEY(`id`) ) ENGINE=InnoDB; CREATETABLEIFNOTEXISTS`spring_boot_series`.`user_auth` ( `id`BIGINTUNSIGNEDNOTNULLAUTO_INCREMENT, `uid`BIGINTNOTNULL, `identity_type`TINYINTNOTNULL, `identifier`VARCHAR(50)NOTNULLDEFAULT'', `certificate`VARCHAR(30)NOTNULLDEFAULT'', `create_time`TIMESTAMPNOTNULLDEFAULTCURRENT_TIMESTAMP, `update_time`TIMESTAMPNOTNULLDEFAULTCURRENT_TIMESTAMPONUPDATECURRENT_TIMESTAMP, PRIMARYKEY(`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:
altertableuser_basemodifybirthdaydatetimenullcomment'生日';
V1.0.2__Modify_user_birthday.sql:
altertableuser_basemodifybirthdaytimestampnullcomment'生日'; altertableuser_baseaddlogin_timetimestampnull;
4.启动SpringBoot应用,以下为数据库为空SpringBoot应用运行时的执行输出
由于配置连接的数据库里没有任何表,所以SpringBoot应用运行时flyway会根据脚本进行数据库的初始化,执行的顺序会根据脚本版本号由低到高按顺序执行(1.0->1.0.1->1.0.2),每执行完一个版本脚本都会向记录表flyway_history_schema插入一条数据。
若添加了新的版本脚本,应用启动时flyway会根据脚本文件版本到记录表flyway_history_schema查询是否有对应的版本脚本被执行了,如果没有相应的版本脚本记录才会执行脚本。
参考
官网文档
示例地址
以上就是SpringBoot集成Flyway进行数据库版本迁移管理的步骤的详细内容,更多关于SpringBoot集成Flyway的资料请关注毛票票其它相关文章!
声明:本文内容来源于网络,版权归原作者所有,内容由互联网用户自发贡献自行上传,本网站不拥有所有权,未作人工编辑处理,也不承担相关法律责任。如果您发现有涉嫌版权的内容,欢迎发送邮件至:czq8825#qq.com(发邮件时,请将#更换为@)进行举报,并提供相关证据,一经查实,本站将立刻删除涉嫌侵权内容。