SpringBoot整合Liquibase實現(xiàn)對數(shù)據(jù)庫管理和遷移
更新時間：2024年11月08日 09:50:01 作者：碼農(nóng)小伙
Liquibase是一個用于用于跟蹤、管理和應用數(shù)據(jù)庫變化的開源工具,通過日志文件(changelog)的形式記錄數(shù)據(jù)庫的變更(changeset),然后執(zhí)行日志文件中的修改,將數(shù)據(jù)庫更新或回滾(rollback)到一致的狀態(tài),本文主要介紹SpringBoot與Liquibase的集成,需要的朋友可以參考下
簡介
Liquibase是一個用于用于跟蹤、管理和應用數(shù)據(jù)庫變化的開源工具，通過日志文件(changelog)的形式記錄數(shù)據(jù)庫的變更(changeset)，然后執(zhí)行日志文件中的修改，將數(shù)據(jù)庫更新或回滾(rollback)到一致的狀態(tài)。它的目標是提供一種數(shù)據(jù)庫類型無關的解決方案，通過執(zhí)行schema類型的文件來達到遷移。本文主要介紹SpringBoot與Liquibase的集成。
優(yōu)點
- 支持幾乎所有主流的數(shù)據(jù)庫，目前支持包括 Oracle/Sql Server/DB2/MySql/Sybase/PostgreSQL等 各種數(shù)據(jù)庫，這樣在數(shù)據(jù)庫的部署和升級環(huán)節(jié)可幫助應用系統(tǒng)支持多數(shù)據(jù)庫；
- 支持版本控制，這樣就能支持多開發(fā)者的協(xié)作維護；
- 日志文件支持多種格式，如XML, YAML, JSON, SQL等；
- 提供變化應用的回滾功能，可按時間、數(shù)量或標簽（tag）回滾已應用的變化。通過這種方式，開發(fā)人員可輕易的還原數(shù)據(jù)庫在任何時間點的狀態(tài)；
- 支持多種運行方式，如命令行、Spring集成、Maven插件、Gradle插件等。
簡單示例
這里主要介紹基于SpringBoot集成liquibase來管理數(shù)據(jù)庫的變更。
POM依賴
Maven 包的依賴，主要包含mysql驅動, JDBC(這里spring-boot-starter-data-jpa包含了jdbc包，當然直接引入jdbc包也行)，以及l(fā)iquibase包。
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.28</version>
</dependency>
<dependency>
<groupId>com.github.wenhao</groupId>
<artifactId>jpa-spec</artifactId>
<version>3.1.0</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<dependency>
<groupId>org.liquibase</groupId>
<artifactId>liquibase-core</artifactId>
<version>4.9.1</version>
</dependency>
yml配置
SpringBoot AutoConfig默認已經(jīng)包含了對liquibase的配置，在spring.liquibase配置下。
基礎的配置，可以直接使用如下（主要是指定change-log的位置，默認的位置是classpath:/db/changelog/db.changelog-master.yaml）：
spring:
datasource:
url: jdbc:mysql://localhost:3306/test_db_liquibase?useSSL=false&autoReconnect=true&characterEncoding=utf8
driver-class-name: com.mysql.cj.jdbc.Driver
username: root
password: bfXa4Pt2lUUScy8jakXf
liquibase:
enabled: true
# 如下配置是被spring.datasource賦值的，所以可以不配置
# url: jdbc:mysql://localhost:3306/test_db_liquibase?useSSL=false&autoReconnect=true&characterEncoding=utf8
# user: root
# password: bfXa4Pt2lUUScy8jakXf
change-log: classpath:/db/changelog/db.changelog-master.yaml
新增changelog
XML方式固然OK，不過依然推薦使用yml格式。
databaseChangeLog:
- changeSet:
id: 20220412-01
author: pdai
changes:
- createTable:
tableName: person
columns:
- column:
name: id
type: int
autoIncrement: true
constraints:
primaryKey: true
nullable: false
- column:
name: firstname
type: varchar(50)
- column:
name: lastname
type: varchar(50)
constraints:
nullable: false
- column:
name: state
type: char(2)
- changeSet:
id: 20220412-02
author: pdai
changes:
- addColumn:
tableName: person
columns:
- column:
name: username
type: varchar(8)
- changeSet:
id: 20220412-03
author: pdai
changes:
- addLookupTable:
existingTableName: person
existingColumnName: state
newTableName: state
newColumnName: id
newColumnDataType: char(2)
測試
啟動springBootApplication, 我們可以看到如下的幾個changeSet被依次執(zhí)行
2022-04-12 20:41:20.591 INFO 8476 --- [ main] liquibase.lockservice : Successfully acquired change log lock 2022-04-12 20:41:20.737 INFO 8476 --- [ main] liquibase.changelog : Creating database history table with name: test_db_liquibase.DATABASECHANGELOG 2022-04-12 20:41:20.783 INFO 8476 --- [ main] liquibase.changelog : Reading from test_db_liquibase.DATABASECHANGELOG Running Changeset: classpath:/db/changelog/db.changelog-master.yaml::20220412-01::pdai 2022-04-12 20:41:20.914 INFO 8476 --- [ main] liquibase.changelog : Table person created 2022-04-12 20:41:20.914 INFO 8476 --- [ main] liquibase.changelog : ChangeSet classpath:/db/changelog/db.changelog-master.yaml::20220412-01::pdai ran successfully in 53ms Running Changeset: classpath:/db/changelog/db.changelog-master.yaml::20220412-02::pdai 2022-04-12 20:41:20.952 INFO 8476 --- [ main] liquibase.changelog : Columns username(varchar(8)) added to person 2022-04-12 20:41:20.952 INFO 8476 --- [ main] liquibase.changelog : ChangeSet classpath:/db/changelog/db.changelog-master.yaml::20220412-02::pdai ran successfully in 31ms Running Changeset: classpath:/db/changelog/db.changelog-master.yaml::20220412-03::pdai 2022-04-12 20:41:21.351 INFO 8476 --- [ main] liquibase.changelog : Lookup table added for person.state 2022-04-12 20:41:21.351 INFO 8476 --- [ main] liquibase.changelog : ChangeSet classpath:/db/changelog/db.changelog-master.yaml::20220412-03::pdai ran successfully in 389ms 2022-04-12 20:41:21.382 INFO 8476 --- [ main] liquibase.lockservice : Successfully released change log lock
查看數(shù)據(jù)庫，你會發(fā)現(xiàn)數(shù)據(jù)已經(jīng)變更
那我們?nèi)绻匦聠舆@個SpringBootApplication，會怎么呢？
很顯然，因為databasechangelog表中已經(jīng)有相關執(zhí)行記錄了，所以將不再執(zhí)行變更
2022-04-12 20:49:01.566 INFO 9144 --- [ main] liquibase.lockservice : Successfully acquired change log lock 2022-04-12 20:49:01.761 INFO 9144 --- [ main] liquibase.changelog : Reading from test_db_liquibase.DATABASECHANGELOG 2022-04-12 20:49:01.812 INFO 9144 --- [ main] liquibase.lockservice : Successfully released change log lock ## 進一步理解 ### 比較好的changelog的實踐 簡單而言：yml格式 + sql-file方式 執(zhí)行sqlFile格式的changeSet，如下  執(zhí)行的日志如下 ```log 2022-04-12 21:00:28.198 INFO 17540 --- [ main] liquibase.lockservice : Successfully acquired change log lock 2022-04-12 21:00:28.398 INFO 17540 --- [ main] liquibase.changelog : Reading from test_db_liquibase.DATABASECHANGELOG Running Changeset: classpath:/db/changelog/db.changelog-master.yaml::20220412-04::pdai 2022-04-12 21:00:28.516 INFO 17540 --- [ main] liquibase.changelog : SQL in file classpath:/db/changelog/db.changelog-20220412-04.sql executed 2022-04-12 21:00:28.516 INFO 17540 --- [ main] liquibase.changelog : ChangeSet classpath:/db/changelog/db.changelog-master.yaml::20220412-04::pdai ran successfully in 83ms 2022-04-12 21:00:28.532 INFO 17540 --- [ main] liquibase.lockservice : Successfully released change log lock
執(zhí)行后，查看變更記錄
數(shù)據(jù)表user表已經(jīng)創(chuàng)建并插入一條數(shù)據(jù)
以上就是SpringBoot整合Liquibase實現(xiàn)對數(shù)據(jù)庫管理和遷移的詳細內(nèi)容，更多關于SpringBoot Liquibase數(shù)據(jù)庫管理和遷移的資料請關注腳本之家其它相關文章！
相關文章
本文主要介紹了淺談Java對象禁止使用基本類型，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2023-02-02
java web監(jiān)聽器統(tǒng)計在線用戶及人數(shù)
本文主要介紹了java web監(jiān)聽器統(tǒng)計在線用戶及人數(shù)的方法解析。具有很好的參考價值。下面跟著小編一起來看下吧2017-04-04
這篇文章主要介紹了淺談使用java實現(xiàn)阿里云消息隊列簡單封裝,小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2018-03-03
常用數(shù)字簽名算法RSA與DSA的Java程序內(nèi)實現(xiàn)示例
這篇文章主要介紹了常用數(shù)字簽名算法RSA與DSA的Java程序內(nèi)實現(xiàn)示例,一般來說DSA算法用于簽名的效率會比RSA要快,需要的朋友可以參考下2016-04-04
本文主要介紹了Springboot Maven打包跳過測試的五種方式小結，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2023-04-04
這篇文章主要為大家詳細介紹了SpringMVC結合天氣api實現(xiàn)天氣查詢，具有一定的參考價值，感興趣的小伙伴們可以參考一下2017-05-05
java.lang.NullPointerException 如何處理空指針異常的實現(xiàn)
這篇文章主要介紹了java.lang.NullPointerException 如何處理空指針異常的實現(xiàn)，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2019-12-12
Java中Optional.of()方法及源碼解析(非常詳細!)
這篇文章主要給大家介紹了關于Java中Optional.of()方法及源碼解析的相關資料,Java中java.util .Optional類的of()方法用于獲得該Optional類中具有指定類型的指定值的一個實例,文中通過代碼介紹的非常詳細,需要的朋友可以參考下2024-06-06
這篇文章主要介紹了idea安裝插件找不到的問題及解決,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2024-06-06
Spring?Boot?+?Mybatis?Plus實現(xiàn)樹狀菜單的方法
這篇文章主要介紹了Spring?Boot?+?Mybatis?Plus實現(xiàn)樹狀菜單，包括實體類中添加子菜單列表和集合及構建菜單樹的詳細代碼，代碼簡單易懂,需要的朋友可以參考下2021-12-12