发布网友 发布时间:2022-04-23 01:14
共2个回答
懂视网 时间:2022-04-11 15:42
Flyway 将 SQL 文件分为 Versioned 、Repeatable 和 Undo 三种:
Versioned 用于版本升级, 每个版本有唯一的版本号并只能执行一次.
Repeatable 可重复执行, 当 Flyway检测到 Repeatable 类型的 SQL 脚本的 checksum
有变动, Flyway 就会重新应用该脚本. 它并不用于版本更新, 这类的 migration
总是在 Versioned 执行之后才被执行。
这三种的命名规则如下图:
V
表示 Versioned, R
表示 Repeatable, U
表示 Undo.
或下划线 _
__
_
或空格 分隔Spring Boot 提供了对 Flyway 的自动配置 。使我们可以开箱即用 Flyway 进行数据库版本控制。
你只需要引入依赖:
<!-- 无需版本号 -->
<dependency>
<groupId>org.flywaydb</groupId>
<artifactId>flyway-core</artifactId>
</dependency>
当然你要集成你的相关数据库环境。这里我们采用 H2 数据库来演示,其它数据库同理只不过方言不同。不熟悉 H2 数据库的可参阅我的专题文章 Spring Boot 2 实战:H2数据库集成以及使用 。
为了直观的讲解配置,首先在 Spring Boot 配置文件 application.yml
我们配置 H2 数据库为:
spring:
datasource:
# h2 驱动
driver-class-name: org.h2.Driver
# h2 数据库 持久化到磁盘D:/h2 库名: flyway mysql模式
url: jdbc:h2:file:D:/h2/flyway;MODE=MySQL;DATABASE_TO_LOWER=TRUE
h2:
# 开启console 访问 默认false
console:
enabled: true
settings:
# 开启h2 console 跟踪 方便调试 默认 false
trace: true
# 允许console 远程访问 默认false
web-allow-others: true
# h2 访问路径上下文
path: /h2-console
对应Flyway的配置为:
# flyway 配置
spring:
flyway:
# 启用或禁用 flyway
enabled: true
# flyway 的 clean 命令会删除指定 schema 下的所有 table, 生产务必禁掉。这个默认值是 false 理论上作为默认配置是不科学的。
clean-disabled: true
# SQL 脚本的目录,多个路径使用逗号分隔 默认值 classpath:db/migration
locations: classpath:db/migration
# metadata 版本控制信息表 默认 flyway_schema_history
table: flyway_schema_history
# 如果没有 flyway_schema_history 这个 metadata 表, 在执行 flyway migrate 命令之前, 必须先执行 flyway baseline 命令
# 设置为 true 后 flyway 将在需要 baseline 的时候, 自动执行一次 baseline。
baseline-on-migrate: true
# 指定 baseline 的版本号,默认值为 1, 低于该版本号的 SQL 文件, migrate 时会被忽略
baseline-version: 1
# 字符编码 默认 UTF-8
encoding: UTF-8
# 是否允许不按顺序迁移 开发建议 true 生产建议 false
out-of-order: false
# 需要 flyway 管控的 schema list,这里我们配置为flyway 缺省的话, 使用spring.datasource.url 配置的那个 schema,
# 可以指定多个schema, 但仅会在第一个schema下建立 metadata 表, 也仅在第一个schema应用migration sql 脚本.
# 但flyway Clean 命令会依次在这些schema下都执行一遍. 所以 确保生产 spring.flyway.clean-disabled 为 true
schemas: flyway
# 执行迁移时是否自动调用验证 当你的 版本不符合逻辑 比如 你先执行了 DML 而没有 对应的DDL 会抛出异常
validate-on-migrate: true
请务必仔细阅读 Flyway 相关配置的说明。
我们先编写一个初始化 SQL 文件,向 H2 数据库已经自动初始化的 schema flyway
添加一张 sys_user
表。请注意命名规则。脚本名称为 V1.0.1__Add_table_user.sql
。SQL 脚本的位置在配置的 spring.flyway.locations
下。内容为:
use `flyway`;
CREATE TABLE `sys_user`
(
`user_id` int(10) unsigned NOT NULL AUTO_INCREMENT,
`username` varchar(1024) NOT NULL unique ,
`encode_password` varchar(1024) NOT NULL,
`age` int(3) NOT NULL,
PRIMARY KEY (`user_id`)
) ENGINE = InnoDB
DEFAULT CHARSET = utf8mb4;
insert into flyway.sys_user values (1,‘Felordcn‘,‘{noop}12345‘,18);
启动 Spring Boot 应用 。打开 H2 数据库控制台 http://localhost:8080/h2-console
,在 JDBC URL 一栏粘贴 jdbc:h2:file:D:/h2/flyway;MODE=MySQL;DATABASE_TO_LOWER=TRUE
并点击 Connect
按钮会进入以下界面:
这里 -1
是因为我们缺省了 Flyway 需要的 flyway_schema_history
表 。0
是因为 H2 数据库自动初始化了 Schema flyway
,其它数据库可能需要你手动来建立。
我们编写一个 V1.0.0__Delete_sysuser_felordcn.sql
来删除 V1.0.1__Add_table_user.sql
中初始化的用户。你会发现启动报错了,因为我们开启了校验,所以对于逻辑错误的版本会抛出异常。我们将版本号更改为 V1.0.2__Delete_sysuser_felordcn.sql
再次启动。通过 H2 数据库控制台我们会发现多了一条变更记录:
同时 sys_user
表的数据也没有了,符合预期。
通过上面的介绍相信你很快就会使用 Flyway 进行数据库版本控制了。这里总结了一些在实际开发中的使用经验:
spring.flyway.cleanDisabled=false
。V1.0.1__ProjectName_{Feature|fix}_Developer_Description.sql
,这种命名同时也可以获取更多脚本的开发者和相关功能的信息。spring.flyway.outOfOrder
取值 生产上使用 false
,开发中使用 true
。schema
时配置spring.flyway.table
为不同的系统设置不同的 metadata
表名而不使用缺省值 flyway_schema_history
。今天我们对 Flyway 数据库版本迁移管理工具进行了介绍并将之与 Spring Boot 相结合。这将大大规范我们的数据库管理,提高生产效率。同时也分享了一些相当有用的生产实践经验。
快速学会像Git一样管理数据库业务版本变更
标签:内容 技术 模式 har version 依次 脚本 下载 启动
热心网友 时间:2022-04-11 12:50
目前最火的版本控制软件就是Git了吧?你要是还用SVN或者CVS什么的都不好意思在圈里打招呼!前天我就遇到这种情况了,QQ上和老同学聊起自己用SVN来管理程序版本,好麻烦,当场就惨遭鄙视---“你还用SVN啊?你Out了!我们都用Git了!”好吧为了不被人鄙视,也为了可以鄙视别人,我终于也开始学Git了!