Flyway 数据库版本控制

背景

在我们日常产品发布的过程中，代码的版本控制可以使用git、svn工具实现。对于数据库每当发布时会出现手动执行sql脚本进行升级数据库，中间经常出现一些漏写、错写情况，对数据库的版本与代码的版本不匹配，导致上线后出现数据库不同步的问题。flyway就是对数据库版本进行控制的工具，可以对不同环境的sql进行迁移操作。

简介

flyway 的官网：Homepage - Flyway

flyway会对每次执行过sql脚本保存到flyway_schema_history中，在数据库中将保存sql脚本的版本号和对sql生成checksum，当下次执行数据库迁移的时候就会按照版本号从低往高执行。如果以前的版本号脚本已经执行过就不会执行，如果以前版本的sql脚本已经被修改在执行的过程中则会报错。对flyway的详细描述与介绍可以查看flyway的官网。

Flyway的工作流程

1. 初次使用时，flyway会创建一个flyway_schema_history表，用于记录sql执行记录

2. 启动flyway后，flyway会自动扫描项目指定路径下的所有sql脚本。与flyway_schema_history表脚本记录进行比对。如果数据库记录执行过的脚本记录，与项目中的sql脚本不一致，flyway会报错并停止项目执行。

3. 如果校验通过，则根据表中的sql记录最大版本号，忽略所有版本号 不大于该版本的脚本。再按照版本号从小到大，逐个执行其余脚本。

maven使用

<plugin>
  			//配置flywaydb的maven插件
				<groupId>org.flywaydb</groupId>
				<artifactId>flyway-maven-plugin</artifactId>
				<version>5.2.4</version>
  			//插件需要配置mysql-connector 注：mysql-connector的版本号与flyway的版本
  号如果flyway 5.2以上对应msyql 8.0
				<dependencies>
					<dependency>
						<groupId>mysql</groupId>
						<artifactId>mysql-connector-java</artifactId>
						<version>8.0.27</version>
					</dependency>
				</dependencies>
       //配置信息
				<configuration>
          //配置用户连接地址
				 <url>jdbc:mysql://192.168.1.1:3306/test?characterEncoding=utf-8</url>
					<user>root</user>
					<password>root080%</password>
          //配置sql脚本的保存位置
					<locations>
						<location>filesystem:sql/flyway/migrate</location>
					</locations>
          //配置baseline版本信息
					<baselineVersion>2.0.0</baselineVersion>
				</configuration>
			</plugin>

配置好以上maven组件，在IDEA中就可以看到flyway的快捷插件了。

在插件中undo不能使用，undo为回滚操作。回滚操作只有使用商业版才能使用。

SQL数据位置

执行

命令行执行

mvn flyway:baseline //初始化数据库链接
mvn flyway:migrate  //迁移数据

IDEA 工具执行(点击baseline、migrate)

SQL脚本命名规范

使用migrate必须开头是V+版本号+“_ _“+描述.sql

如V1.0.3_20220618__increment.sql

插件比较常用的功能介绍

Baseline

对已经存在数据库schema结构的数据库的一种解决方案。实现在非空数据库新建metaData flyway_schema_history表，并把Migrations应用到该数据库；也可以在已有表格的数据库中添加metaData数据表。注：对已有的数据结构的数据库来说，必须要进行baseline，才能进行migrate

Clean

 清楚掉对应数据库Schema中所有的对象，包括表结构，视图，存储过程等，clean操作再dev和test阶段很好用，但是在生产环境务必禁用。

Migrate

执行migrate会在指定文件夹下的sql按照版本号依次执行迁移操作。也就是执行sql脚本，对已经执行过的sql脚本便不再执行。

更多请关注微信公众号【码码码码】