App下載

學(xué)習(xí)springboot項(xiàng)目集成flyway的詳細(xì)過程

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

一、Flyway

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

二、流程

1、 首先配置好flyway的基本信息后,運(yùn)行項(xiàng)目,會(huì)在數(shù)據(jù)庫(kù)表中默認(rèn)新建一個(gè)數(shù)據(jù)表用于存儲(chǔ)flyway的運(yùn)行信息,默認(rèn)的數(shù)據(jù)庫(kù)名:flyway_schema_history

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

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

注意:

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

2.1 導(dǎo)入依賴

<!-- flyway依賴開始 -->
<dependency>
    <groupId>org.flywaydb</groupId>
    <artifactId>flyway-core</artifactId>
</dependency>
<!-- postgresql驅(qū)動(dòng)包 -->
<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:
    # 遷移腳本的位置,默認(rèn)db/migration,可配置
    locations: classpath:/db
    # 已經(jīng)存在表結(jié)構(gòu)數(shù)據(jù)的已有數(shù)據(jù)庫(kù)使用flyway需要設(shè)置為true,且版本號(hào)要比1大
    #baseline-on-migrate: true

2.3 創(chuàng)建sql腳本

/db/V1__init_database.sql

sql腳本的格式:V+版本號(hào) +雙下劃線+描述.sql

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

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為男默認(rèn),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', '測(cè)試', b'1',);

2.4 啟動(dòng)項(xiàng)目

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

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

image-20210425161021257

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

行。

2.5 常見問題

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

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

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

0 人點(diǎn)贊