Java 中Flyway的使用詳解
Flyway的使用
環(huán)境：SpringBoot 2.0.4.RELEASE
為什么要用Flyway？
開發(fā)人員在合作的時候經(jīng)常遇到以下場景：
1.開發(fā)人員A在自己的本地數(shù)據(jù)庫做了一些表結(jié)構(gòu)的改動，并根據(jù)這些改動調(diào)整了DAO層的代碼，然后將代碼上傳到svn或git等版本控制服務(wù)器上。此時如果開發(fā)人員B拉取了A的代碼改動，在運(yùn)行項(xiàng)目的時候很可能會報錯，因?yàn)锽的本地SQL數(shù)據(jù)庫并沒有修改。
2.在項(xiàng)目上線的時候，當(dāng)服務(wù)器拉取的版本控制服務(wù)器的最新修改后，必須同時運(yùn)行SQL數(shù)據(jù)庫的修改腳本，如果忘了跑數(shù)據(jù)庫腳本，那么會出現(xiàn)嚴(yán)重的問題。
傳統(tǒng)的解決方案就是在一個固定的文件夾中，將需要跑的SQL腳本放在里面。開發(fā)人員在合作的時候，A修改了數(shù)據(jù)庫，在B遇到問題的時候，可能需要交流溝通一下，去跑需要的腳本。在項(xiàng)目上線的過程中，也是運(yùn)維人員在規(guī)定的文件夾中，找到需要跑的SQL腳本。運(yùn)行它們。
Flyway等migration工具就是要把開發(fā)人員和運(yùn)維人員從以上這些場景的繁瑣工作中解放出來，如果使用maven的話，那么在項(xiàng)目編譯（SpringBoot運(yùn)行Application）的時候，SQL數(shù)據(jù)庫的改動就自動進(jìn)入數(shù)據(jù)庫，只要啟動成功，開發(fā)或者運(yùn)維人員對SQL數(shù)據(jù)庫的migrate過程是無感知的，項(xiàng)目依然可以照常運(yùn)行。
Flyway是什么？
官方網(wǎng)站：https://flywaydb.org/
Flyway是一個簡單開源數(shù)據(jù)庫版本控制器（約定大于配置），主要提供migrate、clean、info、validate、baseline、repair等命令。它支持SQL（PL/SQL、T-SQL）方式和Java方式，支持命令行客戶端等，還提供一系列的插件支持（Maven、Gradle、SBT、ANT等）。
Flyway最核心的就是用于記錄所有版本演化和狀態(tài)的MetaData表，F(xiàn)lyway首次啟動會創(chuàng)建默認(rèn)名為SCHEMA_VERSION的元素局表。 表中保存了版本，描述，要執(zhí)行的sql腳本等；
sql腳本的格式：V + 版本號 + 雙下劃線(__) + 描述 + 結(jié)束符(.sql)
例如：V1__INIT_DATABASE.sql
命令解釋：
Migrate
Migrate 是指把數(shù)據(jù) Schema 遷移到最新版本，在 Migrate 時會檢查 MetaData 元數(shù)據(jù)表，如果不存在就創(chuàng)建 MetaData 表，MetaData 用于記錄數(shù)據(jù)庫歷史變更等信息；
Migrate會掃描指定文件系統(tǒng)或者 classpath 下的 Migrations。會與 MetaData 中的記錄進(jìn)行對比，進(jìn)行版本升級；
clean
清除掉對應(yīng)數(shù)據(jù)庫 Schema 中所有的對象，包括表結(jié)構(gòu)，視圖，存儲過程等，clean 操作在 dev 和 test 階段很好用；
info
用于打印所有的 Migrations 的詳細(xì)和狀態(tài)信息，也是通過 MetaData 和 Migrations 完成的，可以快速定位當(dāng)前的數(shù)據(jù)庫版本；
validate
驗(yàn)證以及apply的Migrations是否有變更，默認(rèn)開啟的；原理是對比MetaData表與本地Migrations的checkNum值，如果值相同則驗(yàn)證通過，否則失敗
baseline
對已經(jīng)存在數(shù)據(jù)庫Schema結(jié)構(gòu)的數(shù)據(jù)庫一種解決方案。實(shí)現(xiàn)在非空數(shù)據(jù)庫新建MetaData表，并把Migrations應(yīng)用到該數(shù)據(jù)庫；也可以應(yīng)用到已有表結(jié)構(gòu)的數(shù)據(jù)庫中也可以實(shí)現(xiàn)添加Metadata表
repair
repair操作能夠修復(fù)metaData表，該操作在metadata出現(xiàn)錯誤時很有用
用途：
1）：移除失敗的Migration記錄，只針對不支持DDL事務(wù)的數(shù)據(jù)庫
SpringBoot中使用Flyway管理數(shù)據(jù)庫版本
一、添加maven依賴及插件
<!-- https://mvnrepository.com/artifact/org.flywaydb/flyway-core --> <dependency> <groupId>org.flywaydb</groupId> <artifactId>flyway-core</artifactId> <version>5.0.7</version> </dependency> <plugin> <groupId>org.flywaydb</groupId> <artifactId>flyway-maven-plugin</artifactId> </plugin>
添加插件的目的是為了使用上面講到的一些命令：如下圖：
二、開啟Flyway支持、配置Flyway
######################FlyWay####################### # 在沒有元數(shù)據(jù)表的情況下，針對非空Schema執(zhí)行遷移時是否自動調(diào)用基線。 （默認(rèn)值：false） spring.flyway.baseline-on-migrate=true # 下面幾個配置不寫也行，都是默認(rèn)配置，這里寫了是方便以后改 # 執(zhí)行基線時用來標(biāo)記已有Schema的版本。（默認(rèn)值：1） spring.flyway.baseline-version=1 spring.flyway.enabled=true spring.flyway.sql-migration-prefix=V spring.flyway.locations=classpath:db/migration
三、在resource目錄下創(chuàng)建db/migration目錄添加sql腳本
如圖：
下面是 V1.0.0.20190509.0957__flyway_test.sql 腳本
use `spring_boot_building`; DROP TABLE IF EXISTS `table1`; CREATE TABLE `table1` ( `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT, `name` varchar(20) NOT NULL, PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
spring_boot_building 是我的項(xiàng)目連接的數(shù)據(jù)庫
四、驗(yàn)證是否成功
啟動項(xiàng)目，看啟動日志：
打開數(shù)據(jù)庫管理工具，查看數(shù)據(jù)庫：
五、SQL文件版本號命名的規(guī)范
每個公司的規(guī)范肯定不一樣.開發(fā)時,只需要項(xiàng)目內(nèi)遵循該規(guī)范即可,規(guī)范的確定并沒有對錯.提供一種sql文件命名規(guī)范僅供大家參考。
遇到的問題
因?yàn)槲业捻?xiàng)目數(shù)據(jù)庫連接池使用的是Druid，在啟動項(xiàng)目時發(fā)現(xiàn)報異常sql injection violation, part alway true condition not allow，原因是Flyway通過 SQL 腳本來執(zhí)行數(shù)據(jù)庫的建立與更新。當(dāng)同時集成了 Druid 和 Flyway 之后，Druid 的 wall 防火墻極可能直接干預(yù) SQL 腳本的操作，繼而導(dǎo)致 Flyway 執(zhí)行中斷。
網(wǎng)上教程是去掉wall防火墻配置，我試了確實(shí)可以，但是個人覺得這種做法不安全，應(yīng)該還有其他的方法。
參考：
Spring Boot項(xiàng)目使用Flyway
Spring Boot中使用Flyway來管理數(shù)據(jù)庫版本
SpringBoot項(xiàng)目集成Flyway進(jìn)行數(shù)據(jù)庫版本控制
Flyway詳解以及Springboot集成Flyway
到此這篇關(guān)于Java 中Flyway的使用詳解的文章就介紹到這了,更多相關(guān)java Flyway 使用內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
這篇文章主要介紹了Java中時間戳和時間的轉(zhuǎn)換的相關(guān)資料,Java8中時間戳與日期時間對象之間的轉(zhuǎn)換是編程中常見的操作,通過時間字符串獲取時間對象也是其中的一種方法,需要的朋友可以參考下2025-03-03
這篇文章主要為大家介紹了JVM的GC日志及運(yùn)行參數(shù)解讀,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2023-09-09
Spring3 MVC請求參數(shù)獲取的幾種方法小結(jié)
本篇文章主要介紹了Spring3 MVC請求參數(shù)獲取的幾種方法小結(jié)，非常具有實(shí)用價值，需要的朋友可以參考下。2017-03-03
Java導(dǎo)出Excel動態(tài)表頭的示例詳解
這篇文章主要為大家詳細(xì)介紹了Java導(dǎo)出Excel動態(tài)表頭的相關(guān)知識,文中的示例代碼簡潔易懂,具有一定的借鑒價值,有需要的小伙伴可以了解下2025-02-02
這篇文章主要介紹了Spring Aop如何給Advice傳遞參數(shù),文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友可以參考下2020-11-11
Modbus是一種串行通信協(xié)議,Modbus已經(jīng)成為工業(yè)領(lǐng)域通信協(xié)議的業(yè)界標(biāo)準(zhǔn),并且現(xiàn)在是工業(yè)電子設(shè)備之間常用的連接方式,這篇文章主要給大家介紹了關(guān)于java對接Modbus協(xié)議的相關(guān)資料,需要的朋友可以參考下2024-03-03
Java從網(wǎng)絡(luò)讀取圖片并保存至本地實(shí)例
這篇文章主要為大家詳細(xì)介紹了Java從網(wǎng)絡(luò)讀取圖片并保存至本地的實(shí)例，具有一定的參考價值，感興趣的小伙伴們可以參考一下2017-04-04
這篇文章主要介紹了如何設(shè)計和實(shí)現(xiàn)一個簡單的Java命令行計算器程序,該程序能夠執(zhí)行基本的數(shù)學(xué)運(yùn)算（加、減、乘、除）,文中通過代碼介紹的非常詳細(xì),需要的朋友可以參考下2025-01-01
淺談一下SpringCloud中Hystrix服務(wù)熔斷和降級原理
這篇文章主要介紹了淺談一下SpringCloud中Hystrix服務(wù)熔斷和降級原理，Hystrix 是 Netflix 的一款開源的容錯框架，通過服務(wù)隔離來避免由于依賴延遲、異常，引起資源耗盡導(dǎo)致系統(tǒng)不可用的解決方案,需要的朋友可以參考下2023-05-05
關(guān)于Spring事務(wù)隔離、傳播屬性與@Transactional注解
這篇文章主要介紹了關(guān)于事務(wù)隔離、Spring傳播屬性與@Transactional注解,如果一組處理步驟或者全部發(fā)生或者一步也不執(zhí)行，我們稱該組處理步驟為一個事務(wù),需要的朋友可以參考下2023-05-05