flyway教程

weixin_34320159發表於2018-06-22

示例專案地址： https://github.com/14251104246/flyway-demo

[flyway工作原理]（https://flywaydb.org/getstarted/how）

簡單使用（整合 spring boot 直接看下面）

配置

  • 新增依賴
<dependency>
    <groupId>org.flywaydb</groupId>
    <artifactId>flyway-core</artifactId>
    <version>5.1.1</version>
</dependency>
  • 如下新增sql指令碼
7176877-d6c854c795141deb.png
image.png

執行

  • 程式碼如下
public class TestFlyway {
    @Test
    public void flyway(){
        // Create the Flyway instance
        Flyway flyway = new Flyway();

        // Point it to the database
        flyway.setDataSource("jdbc:mysql://127.0.0.1:3306/flyway?useLegacyDatetimeCode=false&serverTimezone=Asia/Hong_Kong&useSSL=false", "root", "123456");

        // Start the migration
        flyway.migrate();
    }
}
  • 執行單元測試
  • 可以看到資料庫多了兩個表（flyway_schema_history是flyway用於儲存版本記錄資訊，users是我們的指令碼建的）
7176877-07764e4ac8fd45d8.png
image.png

spring boot 專案整合flyway

這裡使用的資料庫是一樣的，所以整合spring boot後flyway仍然能知道資料庫的版本記錄

配置

  • 新增依賴
<dependency>
    <groupId>org.flywaydb</groupId>
    <artifactId>flyway-core</artifactId>
    <version>5.1.1</version>
</dependency>

# 資料庫版本控制
flyway:
  enabled: true
  # 若連線的資料庫非空庫，是否初始化
  baseline-on-migrate: true
  # 是否開啟校驗
  validate-on-migrate: false
  # 預設指令碼載入路徑：/db/migration
# locations=classpath:/db/migration
  • 如下新增新版本的sql指令碼（紅框部分是版本號，flyway這時只會執行V1.3版本的指令碼）
7176877-42e65a3c4685bcd5.png
image.png

執行

  • 啟動 spring boot 專案，flyway會自動初始化資料庫
  • 相關日誌輸出如下
2018-06-20 11:12:40.791  INFO 19067 --- [  restartedMain] o.f.core.internal.util.VersionPrinter    : Flyway Community Edition 5.1.1 by Boxfuse
2018-06-20 11:12:40.955  INFO 19067 --- [  restartedMain] o.f.c.internal.database.DatabaseFactory  : Database: jdbc:mysql://127.0.0.1:3306/flyway (MySQL 5.7)
2018-06-20 11:12:40.990  INFO 19067 --- [  restartedMain] o.f.core.internal.command.DbMigrate      : Current version of schema `flyway`: 1.2
2018-06-20 11:12:40.996  INFO 19067 --- [  restartedMain] o.f.core.internal.command.DbMigrate      : Migrating schema `flyway` to version 1.3 - InsertUserAndCreateOrder
2018-06-20 11:12:41.020  INFO 19067 --- [  restartedMain] o.f.core.internal.command.DbMigrate      : Successfully applied 1 migration to schema `flyway` (execution time 00:00.041s)
2018-06-20 11:12:41.140  INFO 19067 --- [  restartedMain] o.s.b.d.a.OptionalLiveReloadServer       : LiveReload server is running on port 35729
2018-06-20 11:12:41.239  INFO 19067 --- [  restartedMain] o.s.j.e.a.AnnotationMBeanExporter        : Registering beans for JMX exposure on startup
2018-06-20 11:12:41.264  INFO 19067 --- [  restartedMain] s.b.c.e.t.TomcatEmbeddedServletContainer : Tomcat started on port(s): 18080 (http)
2018-06-20 11:12:41.267  INFO 19067 --- [  restartedMain] com.neo.Application                      : Started Application in 2.636 seconds (JVM running for 3.202)
  • 資料庫成功插入資料並建立新的表
7176877-5f3d298453b0206c.png
image.png

使用注意

  • 若開啟校驗，flyway在啟動校驗失敗時會清空資料庫中的表和刪除表結構
  • 若不開啟baseline-on-migrate，在連線的資料庫為非空庫時，程式會報錯
  • 若執行sql指令碼失敗，flyway會記錄失敗資訊到flyway_schema_history表，並且下次重新啟動flyway前必須先刪掉失敗資訊，否則會報錯

相關文章