Flyway詳解以及Springboot集成Flyway, 數據庫腳本版本管理

Flayway是一款數據庫版本控制管理工具，，支持數據庫版本自動升級，Migrations可以寫成sql腳本，也可以寫在java代碼里；不僅支持Command Line和java api ，也支持Build構建工具和Spring boot，也可以在分布式環境下能夠安全可靠安全地升級數據庫，同時也支持失敗恢復。

Flyway最核心的就是用於記錄所有版本演化和狀態的MetaData表，Flyway首次啟動會創建默認名為SCHEMA_VERSION的元素局表。 表中保存了版本，描述，要執行的sql腳本等；

sql腳本的格式：V+版本號 +雙下划線+秒速+結束符 

例如：V1__INIT_DATABASE.sql

上面的V 是默認值， 可以通過

flyway.sql-migration-prefix來指定前綴 ，
 

Migrate:

Migrate是指把數據Schema遷移到最新版本，在Migrate時會檢查MetaData元數據表，如果不存在就創建MetaData表，MetaData用於記錄數據庫歷史變更等信息；

Migrate會掃描指定文件系統或者classpath下的Migrations。會與MetaData中的記錄進行對比，進行版本升級；

 

Clean:清除掉對應數據庫Schema中所有的對象，包括表結構，視圖，存儲過程等，clean操作在dev 和 test階段很好用；

 

Info:用於打印所有的Migrations的詳細和狀態信息，也是通過MetaData和Migrations完成的，可以快速定位當前的數據庫版本；

 

validate:驗證以及apply的Migrations是否有變更，默認開啟的；原理是對比MetaData表與本地Migrations的checkNum值，如果值相同則驗證通過，否則失敗。

 

BaseLine：對已經存在數據庫Schema結構的數據庫一種解決方案。實現在非空數據庫新建MetaData表，並把Migrations應用到該數據庫；也可以應用到已有表結構的數據庫中也可以實現添加Metadata表。

repair：repair操作能夠修復metaData表，該操作在metadata出現錯誤時很有用

用途：

  1）：移除失敗的Migration記錄，只針對不支持DDL事務的數據庫

使用Flayway:

1、引入flyway的依賴：

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

如果是springboot 2.xx,使用

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

2、新建一個maven的Springboot項目，在配置文件中配置數據源信息：

server.port=8088
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/testdb
spring.datasource.username=root
spring.datasource.password=
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

3、在classpath下新建/db/migration文件夾，並創建sql腳本文件：

use testdb;
 
CREATE TABLE person (
  id int(11) NOT NULL AUTO_INCREMENT,
  first varchar(100) NOT NULL,
  last varchar(100) NOT NULL,
  dateofbirth DATE DEFAULT null,
  placeofbirth varchar(100) not null,
  PRIMARY KEY (id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

 

4、啟動springboot項目：

加載了sql腳本 。

5、查看數據庫：

生成了flyway-schema-history表，這個版本默認是這個表，如果想自己指定schema表的命，可以設置：

flyway.tableflyway

6：flyway的一些其他配置：

spring.flyway.baseline-description對執行遷移時基准版本的描述.
spring.flyway.baseline-on-migrate當遷移時發現目標schema非空，而且帶有沒有元數據的表時，是否自動執行基准遷移，默認false.
spring.flyway.baseline-version開始執行基准遷移時對現有的schema的版本打標簽，默認值為1.
spring.flyway.check-location檢查遷移腳本的位置是否存在，默認false.
spring.flyway.clean-on-validation-error當發現校驗錯誤時是否自動調用clean，默認false.
spring.flyway.enabled是否開啟flywary，默認true.
spring.flyway.encoding設置遷移時的編碼，默認UTF-8.
spring.flyway.ignore-failed-future-migration當讀取元數據表時是否忽略錯誤的遷移，默認false.
spring.flyway.init-sqls當初始化好連接時要執行的SQL.
spring.flyway.locations遷移腳本的位置，默認db/migration.
spring.flyway.out-of-order是否允許無序的遷移，默認false.
spring.flyway.password目標數據庫的密碼.
spring.flyway.placeholder-prefix設置每個placeholder的前綴，默認${.
spring.flyway.placeholder-replacementplaceholders是否要被替換，默認true.
spring.flyway.placeholder-suffix設置每個placeholder的后綴，默認}.
spring.flyway.placeholders.[placeholder name]設置placeholder的value
spring.flyway.schemas設定需要flywary遷移的schema，大小寫敏感，默認為連接默認的schema.
spring.flyway.sql-migration-prefix遷移文件的前綴，默認為V.
spring.flyway.sql-migration-separator遷移腳本的文件名分隔符，默認__
spring.flyway.sql-migration-suffix遷移腳本的后綴，默認為.sql
spring.flyway.tableflyway使用的元數據表名，默認為schema_version
spring.flyway.target遷移時使用的目標版本，默認為latest version
spring.flyway.url遷移時使用的JDBC URL，如果沒有指定的話，將使用配置的主數據源
spring.flyway.user遷移數據庫的用戶名
spring.flyway.validate-on-migrate遷移時是否校驗，默認為true.

版權聲明：本文為CSDN博主「Jennire_Q」的原創文章，遵循 CC 4.0 BY-SA 版權協議，轉載請附上原文出處鏈接及本聲明。
原文鏈接：https://blog.csdn.net/qiuhao9527/article/details/81070482