1. Flyway简介
Flayway是一款数据库版本控制管理工具,支持数据库版本自动升级,Migrations可以写成sql脚本,也可以写在java代码里;不仅支持Command Line和java api ,也支持Build构建工具和Spring boot,也可以在分布式环境下能够安全可靠安全地升级数据库,同时也支持失败恢复。
Flyway最核心的就是用于记录所有版本演化和状态的MetaData表,Flyway首次启动会创建默认名为SCHEMA_VERSION的元素局表。 表中保存了版本,描述,要执行的sql脚本等。
2. SQL脚本命名规则
sql脚本的格式:V+版本号 +双下划线+描述+结束符
例如:
V1__INIT_DATABASE.sql
上面的V 是默认值, 可以通过flyway.sql-migration-prefix来指定前缀。
3. 添加maven依赖
<dependency>
<groupId>org.flywaydb</groupId>
<artifactId>flyway-core</artifactId>
</dependency>
4. 配置数据源信息
spring.datasource.url=jdbc:mysql://localhost:3306/config_center
spring.datasource.username=root
spring.datasource.password=123456
spring.datasource.name=datasource
#这里使用的是MySQL 8
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
5. 新建脚本文件
在resources目录下新建/db/migration目录,并新建sql文件,如:V2019.03.29__INIT_DATABASE.sql
CREATE TABLE config_center.config (
id int(11) NOT NULL AUTO_INCREMENT,
name varchar(128) UNIQUE NOT NULL,
value varchar(255) NOT NULL,
application varchar(50) NOT NULL,
profile varchar(50) NOT NULL,
label varchar(50) NOT NULL,
PRIMARY KEY (id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
INSERT INTO config_center.config VALUES(1, 'easybook.info.description', 'You and me happy fly in the sky!', 'config-client', 'stage', 'master');
6. 启动SpringBoot项目
启动项目,查看数据库,发现数据库已生成。
7. Flyway常用配置
配置 | 说明 |
---|---|
spring.flyway.baseline-description | 对执行迁移时基准版本的描述 |
spring.flyway.baseline-on-migrate | 当迁移时发现目标schema非空,而且带有没有元数据的表时,是否自动执行基准迁移,默认false |
spring.flyway.baseline-version | 开始执行基准迁移时对现有的schema的版本打标签,默认值为1 |
spring.flyway.check-location | 检查迁移脚本的位置是否存在,默认false |
spring.flyway.clean-on-validation-error | 当发现校验错误时是否自动调用clean,默认false |
spring.flyway.enabled | 是否开启flywary,默认true |
spring.flyway.encoding | 设置迁移时的编码,默认UTF-8 |
spring.flyway.ignore-failed-future-migration | 当读取元数据表时是否忽略错误的迁移,默认false |
spring.flyway.init-sqls | 当初始化好连接时要执行的SQL |
spring.flyway.locations | 迁移脚本的位置,默认db/migration |
spring.flyway.out-of-order | 是否允许无序的迁移,默认false |
spring.flyway.password | 目标数据库的密码 |
spring.flyway.placeholder-prefix | 设置每个placeholder的前缀,默认${ |
spring.flyway.placeholder-replacement | placeholders是否要被替换,默认true |
spring.flyway.placeholder-suffix | 设置每个placeholder的后缀,默认} |
spring.flyway.placeholders.[placeholder name] | 设置placeholder的value |
spring.flyway.schemas | 设定需要flywary迁移的schema,大小写敏感,默认为连接默认的schema |
spring.flyway.sql-migration-prefix | 迁移文件的前缀,默认为V |
spring.flyway.sql-migration-separator | 迁移脚本的文件名分隔符,默认__ |
spring.flyway.sql-migration-suffix | 迁移脚本的后缀,默认为.sql |
spring.flyway.tableflyway | 使用的元数据表名,默认为schema_version |
spring.flyway.target | 迁移时使用的目标版本,默认为latest version |
spring.flyway.url | 迁移时使用的JDBC URL,如果没有指定的话,将使用配置的主数据源 |
spring.flyway.user | 迁移数据库的用户名 |
spring.flyway.validate-on-migrate | 迁移时是否校验,默认为true |