准备
- 官网地址: Documentation - Flyway by Redgate • Database Migrations Made Easy.
- 快速集成: Community Plugins and Integrations - Community Plugins and Integrations - Flyway by Redgate • Database Migrations Made Easy.(首页位置点击插件进入即可)
说明:
- 开箱即用: “How-to” Guides
- Flyway迁移脚本命名规范:Migrations - Migrations - Flyway by Redgate • Database Migrations Made Easy.
Spring Boot supports two higher-level migration tools: Flyway and Liquibase.
如果你是为了快速集成组件到当前项目中,可以参考本篇文章的中的关键配置达到应用的效果。但是你如果想要知道为什么要这么做,作何解释相信上面的链接导引一定可以节省你很多时间!!!
集成
Springboot集成
加入依赖信息(备注版本:5.2.0)
<dependency> <groupId>org.flywaydb</groupId> <artifactId>flyway-core</artifactId> <version>8.3.0</version> </dependency> compile "org.flywaydb:flyway-core:8.3.0"
集成到springboot中可选的配置:
Spring项目配置文件
精简配置即可实现springboot对于flyway的集成:
spring.flyway.enabled=true spring.flyway.locations=classpath:flyway/sql spring.flyway.baseline-on-migrate=true # 说明,在spring boot 1.x中,属性前缀为flyway,在spring boot 2.x中为spring.flyway,需要区分不同版本
location参数定义了flyway文件执行的位置,具体定义文件的格式以及使用我在官网也找到了对应的参考地址:
关于locations参数的说明这里多提一句,在加成配置文件地址的时候支持两种方式:classpath
、 filesystem
spring.flyway.locations=classpath:db/migration,filesystem:/opt/migration
不得不说,springboot家的文档还是比较全的,但是如果不是有合适切入口,找这些文档还是挺费时间的!
在项目配置的locations的位置进编写指定的脚本文件即可:
脚本配置文件规则
在集成到Springboot项目中的时候我们指定了一个配置文件的属性叫做:locations
,这个属性制定了生效的脚本所在的位置,但是脚本文件的名称具有一定的约束性,还是老样子先给出官网的解释文档:(我始终认为,网上搜罗的博客或者是文章大部分都是从官网抄过来的,但是工作了一段时间之后我们对这些问题解决方案和知识的来源要有所思考,不能大家说什么就是什么。)
Migrations - Migrations - Flyway by Redgate • Database Migrations Made Easy.
简单总结官网说的大致意思,脚本执行的前缀是有限制的:V U R。分表代表执行的操作为 执行一次,撤销操作 重复迁移操作。具体详细说明可以去官网查询了解。
实际上在真实项目开发中,我想在大多数使用的脚本还是这个样子:
classpath: V1_1__create_sql.sql V1_2__create_sql.sql V1_3__create_sql.sql V1_4__create_sql.sql .... VXXX_XXX__create_sql.sql
实际上组件提供的功能你可以编写达到的效果是这个样子的:
自动装配
为何能够实现自动配置可以参考springboot配置包文件中的自动配置类:
我这里并打算对这个组件的源代码做深入的了解,所以只是列除了能够实现自动配置的原因。后面,留一个章节等我弄懂这个东西的大致实现原理,会在后面在做阐述。