App下載

學(xué)習springboot項目集成flyway的詳細過程

我的夏天來了 2021-08-19 15:18:07 瀏覽數(shù) (4727)
反饋

一、Flyway

Flyway是獨立于數(shù)據(jù)庫的應(yīng)用、管理并跟蹤數(shù)據(jù)庫變更的數(shù)據(jù)庫版本管理工具。用通俗的話講,F(xiàn)lyway可以像Git管理不同人的代碼那樣,管理不同人的sql腳本,從而做到數(shù)據(jù)庫同步。

二、流程

1、 首先配置好flyway的基本信息后,運行項目,會在數(shù)據(jù)庫表中默認新建一個數(shù)據(jù)表用于存儲flyway的運行信息,默認的數(shù)據(jù)庫名:flyway_schema_history

2、 緊接著Flyway將開始掃描文件系統(tǒng)或應(yīng)用程序的類路徑進行遷移。然后,F(xiàn)lyway的數(shù)據(jù)遷移將基于對用sql腳本的版本號進行排序,并按順序應(yīng)用:

可以看到執(zhí)行數(shù)據(jù)庫表后在checksum中儲存一個數(shù)值,用于在之后運行過程中對比sql文件執(zhí)行是否有變化。

注意:

flyway在執(zhí)行腳本時,會在源數(shù)據(jù)表中檢查checksum值,并確定上次運行到哪一個腳本文件,本次執(zhí)行時從下一條腳本文件開始執(zhí)行。所以編寫腳本的時候不要去修改原有的腳本內(nèi)容,并且新的腳本版本號要連續(xù)

2.1 導(dǎo)入依賴

<!-- flyway依賴開始 -->
<dependency>
    <groupId>org.flywaydb</groupId>
    <artifactId>flyway-core</artifactId>
</dependency>
<!-- postgresql驅(qū)動包 -->
<dependency>
    <groupId>org.postgresql</groupId>
    <artifactId>postgresql</artifactId>
    <scope>runtime</scope>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-jdbc</artifactId>
</dependency>
 <!-- flyway依賴結(jié)束 -->
<build>
    <plugins>
        <plugin>
            <groupId>org.flywaydb</groupId>
            <artifactId>flyway-maven-plugin</artifactId>
            <version>5.2.1</version>
        </plugin>
    </plugins>
 </build>

2.2 配置yml

spring:
  #druid數(shù)據(jù)源
  datasource:
    druid:
      db-type: com.alibaba.druid.pool.DruidDataSource
      driverClassName: net.sf.log4jdbc.sql.jdbcapi.DriverSpy
      url: jdbc:log4jdbc:mysql://127.0.0.1/plumvill_test?serverTimezone=Asia/Shanghai&characterEncoding=utf8&useSSL=false&allowPublicKeyRetrieval=true
      username: root
      password: 123456
  flyway:
    # 遷移腳本的位置,默認db/migration,可配置
    locations: classpath:/db
    # 已經(jīng)存在表結(jié)構(gòu)數(shù)據(jù)的已有數(shù)據(jù)庫使用flyway需要設(shè)置為true,且版本號要比1大
    #baseline-on-migrate: true

2.3 創(chuàng)建sql腳本

/db/V1__init_database.sql

sql腳本的格式:V+版本號 +雙下劃線+描述.sql

說明:V大寫,中間是兩個下劃線(__)

USE plumvill_test;

SET NAMES utf8mb4;
SET FOREIGN_KEY_CHECKS = 0;

-- ----------------------------
-- Table structure for sys_user
-- ----------------------------
DROP TABLE IF EXISTS `sys_user`;
CREATE TABLE `sys_user`  (
  `id` bigint(0) UNSIGNED NOT NULL AUTO_INCREMENT COMMENT 'ID',
  `username` varchar(255) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL DEFAULT '' COMMENT '用戶名',
  `nick_name` varchar(255) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL DEFAULT '' COMMENT '昵稱',
  `gender` bit(1) NOT NULL DEFAULT b'0' COMMENT '性別(0為男默認,1為女)',
) ENGINE = InnoDB AUTO_INCREMENT = 3 CHARACTER SET = utf8mb4 COLLATE = utf8mb4_general_ci COMMENT = '系統(tǒng)用戶' ROW_FORMAT = Compact;

-- ----------------------------
-- Records of sys_user
-- ----------------------------
INSERT INTO `sys_user` VALUES (1, 'admin', '管理員', b'0');
INSERT INTO `sys_user` VALUES (2, 'test', '測試', b'1',);

2.4 啟動項目

可以看到sql腳本開始執(zhí)行

執(zhí)行成功后可以發(fā)現(xiàn)數(shù)據(jù)庫中多出一張flyway_schema_history 的表來記錄每次腳本的執(zhí)行

image-20210425161021257

以后只要數(shù)據(jù)庫有更新,只需要在db文件夾下創(chuàng)建更高版本的sql腳本(V1.x__xxx.sql,V2__xxx.sql),重啟項目的時候就會自動執(zhí)

行。

2.5 常見問題

1、可以基于環(huán)境變量,實現(xiàn)不同的環(huán)境,做不同的初始化腳本嗎?
基于我們的配置中 心,可以對flyway.locations配置進行修改,不同環(huán)境的初始化腳本可以放到不同的目錄下。

2、初始化數(shù)據(jù)過程會發(fā)生錯誤回滾?
每 一個sql 文件會有 一個單獨的事物,如果單個文件中發(fā) 生錯誤,單個文件的操作會回滾, 比如有1、2、3個 文件,第 二個文件發(fā)生錯誤,第二個文件所有操作將會回滾,第三個文件不會執(zhí)行。但: Unfortunately, today only DB2, PostgreSQL, Derby, EnterpriseDB and to a certain extent SQL Server support DDL statements inside a transaction。 所以,建議不要把ddl 文件和dml語句句放到同 一個文件 里,避免不必要的麻煩

到此這篇關(guān)于SpringBoot項目集成Flyway詳細過程的文章就介紹到這了,更多相關(guān)SpringBoot Flyway的內(nèi)容,請搜索W3Cschool以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持!

0 人點贊