springboot配置flyway(入門級別教程）

更新時間：2023年09月12日 15:30:11 作者：Mayz梅子子子

本文介紹了springboot配置flyway,主要介紹基于SpringBoot集成flyway來管理數(shù)據(jù)庫的變更,具有一定的參考價值,感興趣的可以了解一下

1、Flyway的工作原理

Flyway在第一次執(zhí)行時，會創(chuàng)建一個默認名為flyway_schema_history的歷史記錄表，這張表會用來跟蹤或記錄數(shù)據(jù)庫的狀態(tài)，然后每次項目啟動時都會自動掃描在resources/db/migration下的文件的版本號并且通過查詢flyway_schema_history來判斷是否有新增文件，從而判斷是否進行遷移。默認的查找 migration 的路徑為 classpath:db/migration ，對應 SQL 文件可放置在src/main/resources/db/migration 下，Java 類可放置在 src/main/java/db/migration 下。

2、sql腳本命名規(guī)則

僅需要執(zhí)行一次的，以大寫“V”開頭，V+版本后（版本號間的數(shù)字以“.” 或者“ _ ”分隔開，“ _ ”會自動編譯成 “ . ” ）+" __"+文件描述+后綴名；
需要執(zhí)行多次的，以大寫“R”開頭，命名如R__clean.sql ，R的腳本只要改變了就會執(zhí)行,R不帶版本號；
V開頭的比R開頭的優(yōu)先級要高。

前綴：用于版本控制（可配置）、撤消（可配置）和可重復遷移（可配置）VUR)
版本：帶有點或下劃線的版本可根據(jù)需要分隔任意數(shù)量的部分（不適用于可重復的遷移）
分隔符：（兩個下劃線）（可配置）__)
說明：下劃線或空格分隔單詞
后綴：（可配置.sql)
（可選）版本控制 SQL 遷移還可以省略分隔符和說明

3、引入maven依賴

    <!-- flyaway工具 -->
    <dependency>
        <groupId>org.flywaydb</groupId>
        <artifactId>flyway-core</artifactId>
        <version>5.2.4</version>
    </dependency

4、添加yml配置項（不做專門配置說明的配置項按照默認值）

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

我的項目中只做了這些配置：