快捷導(dǎo)航

詳解Spring Boot中使用Flyway來(lái)管理數(shù)據(jù)庫(kù)版本

更新時(shí)間：2018年01月03日 09:09:28 作者：翟永超

這篇文章主要介紹了詳解Spring Boot中使用Flyway來(lái)管理數(shù)據(jù)庫(kù)版本，小編覺(jué)得挺不錯(cuò)的，現(xiàn)在分享給大家，也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧

如果沒(méi)有讀過(guò)上面內(nèi)容的讀者，有興趣的可以一閱。在上面的使用JdbcTemplate一文中，主要通過(guò)spring提供的JdbcTemplate實(shí)現(xiàn)對(duì)用戶表的增刪改查操作。在實(shí)現(xiàn)這個(gè)例子的時(shí)候，我們事先在MySQL中創(chuàng)建了用戶表。創(chuàng)建表的過(guò)程我們?cè)趯?shí)際開(kāi)發(fā)系統(tǒng)的時(shí)候會(huì)經(jīng)常使用，但是一直有一個(gè)問(wèn)題存在，由于一個(gè)系統(tǒng)的程序版本通過(guò)git得到了很好的版本控制，而數(shù)據(jù)庫(kù)結(jié)構(gòu)并沒(méi)有，即使我們通過(guò)Git進(jìn)行了語(yǔ)句的版本化，那么在各個(gè)環(huán)境的數(shù)據(jù)庫(kù)中如何做好版本管理呢？下面我們就通過(guò)本文來(lái)學(xué)習(xí)一下在Spring Boot中如何使用Flyway來(lái)管理數(shù)據(jù)庫(kù)的版本。

Flyway簡(jiǎn)介

Flyway是一個(gè)簡(jiǎn)單開(kāi)源數(shù)據(jù)庫(kù)版本控制器（約定大于配置），主要提供migrate、clean、info、validate、baseline、repair等命令。它支持SQL（PL/SQL、T-SQL）方式和Java方式，支持命令行客戶端等，還提供一系列的插件支持（Maven、Gradle、SBT、ANT等）。

官方網(wǎng)站：https://flywaydb.org/

本文對(duì)于Flyway的自身功能不做過(guò)多的介紹，讀者可以通過(guò)閱讀官方文檔或利用搜索引擎獲得更多資料。下面我們具體說(shuō)說(shuō)在Spring Boot應(yīng)用中的應(yīng)用，如何使用Flyway來(lái)創(chuàng)建數(shù)據(jù)庫(kù)以及結(jié)構(gòu)不一致的檢查。

動(dòng)手試一試

下面我們可以通過(guò)對(duì)使用JdbcTemplate一文中的例子進(jìn)行加工完成。讀者也可以拿任何一個(gè)與數(shù)據(jù)訪問(wèn)相關(guān)的工程來(lái)做如下內(nèi)容的實(shí)驗(yàn)：

第一步，在pom.xml中增加flyway的依賴：

<dependency>
 <groupId>org.flywaydb</groupId>
 <artifactId>flyway-core</artifactId>
 <version>5.0.3</version>
</dependency>

第二步，按Flyway的規(guī)范創(chuàng)建版本化的SQL腳本。

在工程的src/main/resources目錄下創(chuàng)建db目錄

在db目錄下創(chuàng)建版本化的SQL腳本V1__Base_version.sql

DROP TABLE IF EXISTS user ;
CREATE TABLE `user` (
 `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主鍵',
 `name` varchar(20) NOT NULL COMMENT '姓名',
 `age` int(5) DEFAULT NULL COMMENT '年齡',
 PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

第三步，在application.properties文件中配置Flyway要加載的SQL腳本位置。按第二步創(chuàng)建的結(jié)果配置如下：

flyway.locations=classpath:/db

第四步，執(zhí)行單元測(cè)試ApplicationTests，此時(shí)我們?cè)谌罩局锌梢钥吹饺缦滦畔ⅲ?br />

INFO 82441 --- [main] o.f.core.internal.util.VersionPrinter  : Flyway Community Edition 5.0.3 by Boxfuse
INFO 82441 --- [main] o.f.c.internal.database.DatabaseFactory : Database: jdbc:mysql://localhost:3306/test (MySQL 5.7)
INFO 82441 --- [main] o.f.core.internal.command.DbValidate   : Successfully validated 1 migration (execution time 00:00.022s)
INFO 82441 --- [main] o.f.c.i.s.JdbcTableSchemaHistory     : Creating Schema History table: `test`.`flyway_schema_history`
INFO 82441 --- [main] o.f.core.internal.command.DbMigrate   : Current version of schema `test`: << Empty Schema >>
INFO 82441 --- [main] o.f.core.internal.command.DbMigrate   : Migrating schema `test` to version 1 - Base version
WARN 82441 --- [main] o.f.core.internal.sqlscript.SqlScript  : DB: Unknown table 'test.user' (SQL State: 42S02 - Error Code: 1051)
INFO 82441 --- [main] o.f.core.internal.command.DbMigrate   : Successfully applied 1 migration to schema `test` (execution time 00:00.128s)

Flyway監(jiān)測(cè)到需要運(yùn)行版本腳本來(lái)初始化數(shù)據(jù)庫(kù)，因此執(zhí)行了V1__Base_version.sql腳本，從而創(chuàng)建了user表，這才得以讓一系列單元測(cè)試（對(duì)user表的CRUD操作）通過(guò)。

第五步，我們可以繼續(xù)再執(zhí)行一下單元測(cè)試，此時(shí)我們會(huì)發(fā)現(xiàn)日志輸出與之前不同：

INFO 83150 --- [main] o.f.core.internal.util.VersionPrinter  : Flyway Community Edition 5.0.3 by Boxfuse
INFO 83150 --- [main] o.f.c.internal.database.DatabaseFactory : Database: jdbc:mysql://localhost:3306/test (MySQL 5.7)
INFO 83150 --- [main] o.f.core.internal.command.DbValidate   : Successfully validated 1 migration (execution time 00:00.031s)
INFO 83150 --- [main] o.f.core.internal.command.DbMigrate   : Current version of schema `test`: 1
INFO 83150 --- [main] o.f.core.internal.command.DbMigrate   : Schema `test` is up to date. No migration necessary.

由于在第四步的時(shí)候，初始化腳本已經(jīng)執(zhí)行過(guò)，所以這次執(zhí)行就沒(méi)有再去執(zhí)行V1__Base_version.sql腳本來(lái)重建user表。

第六步，我們可以嘗試修改一下V1__Base_version.sql腳本中的name字段長(zhǎng)度，然后在運(yùn)行一下單元測(cè)試，此時(shí)我們可以得到如下錯(cuò)誤：

ERROR 83791 --- [main] o.s.boot.SpringApplication        : Application startup failed

org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'flywayInitializer' defined in class path resource [org/springframework/boot/autoconfigure/flyway/FlywayAutoConfiguration$FlywayConfiguration.class]: Invocation of init method failed; nested exception is org.flywaydb.core.api.FlywayException: Validate failed: Migration checksum mismatch for migration version 1
-> Applied to database : 466264992
-> Resolved locally  : -270269434

由于初始化腳本的改動(dòng)，F(xiàn)lyway校驗(yàn)失敗，認(rèn)為當(dāng)前的V1__Base_version.sql腳本與上一次執(zhí)行的內(nèi)容不同，提示報(bào)錯(cuò)并終止程序，以免造成更嚴(yán)重的數(shù)據(jù)結(jié)構(gòu)破壞。

總結(jié)

到這里為止，本文的內(nèi)容告一段落。由于博文篇幅問(wèn)題，對(duì)于Flyway更細(xì)節(jié)的使用沒(méi)有說(shuō)的太多，本文主要作為敲門磚，幫助和引導(dǎo)正在使用Spring Boot做系統(tǒng)開(kāi)發(fā)的個(gè)人或團(tuán)隊(duì)在數(shù)據(jù)庫(kù)的版本控制上做的更好提供一些思路。至于更深入的應(yīng)用還請(qǐng)讀者自行翻閱官方文檔參考和學(xué)習(xí)。

本文代碼:Github：https://github.com/dyc87112/SpringBoot-Learning/

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

您可能感興趣的文章: