Spring Boot项目集成flyway
一、为什么要使用flyway
Flyway的定位:数据库的版本控制。
用一种简单、干净的方案,帮助用户完成数据库迁移的工作。使用Flyway,用户可以从任意一个数据库版本迁移到最新版本,简单而且有效。
支持多个平台:windows、ios、linux、docker、java、android
二、如何使用flyway
2.1 添加依赖(推荐版本)
注意:5.2.1之后版本存在已知Bug,在Flyway 执行时报错: 'user_variables_by_thread' 表没有SELECT权限的问题解决,详情请参考官方issues
<dependency> <groupId>org.flywaydb</groupId> <artifactId>flyway-core</artifactId> <version>5.2.1</version> </dependency>
2.2添加配置
spring:
# 数据库版本控制
flyway:
enabled: true
# 若连接的数据库非空库,是否初始化
baseline-on-migrate: true
# 是否开启校验(若开启校验,flyway在启动校验失败时会清空数据库中的表和删除表结构)
validate-on-migrate: false
# 默认脚本加载路径:/db/migration
locations: classpath:/db/migration
#存储初始化数据的表名
table: sysmn_flyway_schema_history
2.3 添加初始化文件
在 Spring Boot项目 的 resources 目录下创建 db.migration目录 并添加名称为 V202007131636__init.sql 文件
注意:
V:版本前缀(若配置中无特殊配置,必须为“V”)
202007131636:版本号 (新添加的配置文件必须必之前的版本号大)
__ : 双下划线(重点:双下划线)
init:区分标识(init表示初始化数据库表)
.sql :后缀(不可更改)
V202007131636__init.sql 文件具体内容如下:
-- sql脚本文件 -- 命名规则 年月日时分__姓名.sql use controller_db; CREATE TABLE `test` ( `ID` int(11) NOT NULL AUTO_INCREMENT COMMENT '数据主键ID', `DATA_VERSION` int(11) NOT NULL DEFAULT '1' COMMENT '版本号', `GMT_CREATE` datetime NOT NULL COMMENT '数据创建时间', `GMT_MODIFY` datetime DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP COMMENT '数据修改时间', `ORG_CODE` varchar(50) DEFAULT NULL COMMENT '用户所在机构', `USER_CODE` varchar(255) DEFAULT NULL COMMENT '用户代码', `USER_NAME` varchar(100) DEFAULT NULL COMMENT '用户姓名', `USER_CLASS` varchar(100) DEFAULT NULL COMMENT '用户类型', `PERSON_CODE` varchar(100) DEFAULT NULL COMMENT '服务人员代码', `LOGIN_NAME` varchar(100) NOT NULL COMMENT '系统用户登录名', `LOGIN_PWD` varchar(200) NOT NULL COMMENT '登录密码', `HEAD_PORTRAIT` varchar(1000) DEFAULT NULL COMMENT '用户头像', `USER_TITLE` varchar(100) DEFAULT NULL COMMENT '用户职称', `ENABLE_FLAG` varchar(10) DEFAULT '0' COMMENT '启用标识 0-未启用 1-启用', `LOCK_FLAG` varchar(10) DEFAULT '0' COMMENT '锁定标识 1-锁定 0-正常', `PY_CODE` varchar(100) DEFAULT NULL COMMENT '拼音码', `WB_CODE` varchar(100) DEFAULT NULL COMMENT '五笔码', `THIRD_CODE` varchar(100) DEFAULT NULL COMMENT '第三方编码', `LAST_LOGIN_DATE` datetime DEFAULT NULL COMMENT '用户最后登录时间', `LOGIN_COUNT` int(11) DEFAULT NULL COMMENT '累计登录次数', `SORT_NO` int(11) DEFAULT '0' COMMENT '排序号', `AUDIT_FLAG` varchar(1) DEFAULT NULL COMMENT '是否需要审核 0:不需要审核 1:需要审核', `AUDIT_PASS` varchar(1) DEFAULT NULL COMMENT '审核结果 审核标识为1时启用,FD000010,0:未审核1:通过,2:不通过', `REMARK` varchar(1000) DEFAULT NULL COMMENT '备注(审核不通过时是不通过原因)', `AUDIT_USER_CODE` varchar(50) DEFAULT NULL COMMENT '审核人CODE', `AUDIT_TIME` datetime DEFAULT NULL COMMENT '审核时间', `VALID_TIME` datetime DEFAULT NULL COMMENT '生效时间', `UNVALID_TIME` datetime DEFAULT NULL COMMENT '失效时间', `BACK_IMAGE` varchar(255) DEFAULT NULL COMMENT '主题背景图片地址', `DELETE_FLAG` varchar(1) DEFAULT '0' COMMENT '删除标志 1 删除 0 未删除', `IS_FICTITIOUS` varchar(1) DEFAULT '0' COMMENT '是否为虚拟用户FD000018 0-否 1-是', `STATUS_RELATION` varchar(1) DEFAULT '0' COMMENT '是否为医疗机构停用关联的停用FD000018:0-否,1-是', PRIMARY KEY (`ID`) USING BTREE, UNIQUE KEY `SYS_USER_IDX1` (`LOGIN_NAME`,`DELETE_FLAG`) USING BTREE, UNIQUE KEY `UI_SYS_USER` (`USER_CODE`,`DELETE_FLAG`) USING BTREE ) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8 COMMENT='系统用户表'; INSERT INTO `test` VALUES (null, 9, '2020-05-26 15:42:28', '2020-05-23 17:34:05', '0000000003', '000014', '测试', '05', '000005', 'wgx', 'e9cdd7cacf3940e525f283f5fa4fa33a', 'http://static.ruiyicloud.com.cn/image/big-platform/head-picture/000014/0000141590226435000', '05', '0', '0', 'CS', 'IY', NULL, NULL, NULL, 21, '1', '1', NULL, NULL, NULL, '2020-05-23 14:26:09', '2020-05-23 15:58:14', NULL, '0', '0', '0');
至此,已经完成了Spring Boot项目集成flyway,非常简单。