SpringBoot項目使用Liquibase數(shù)據(jù)庫版本管理方式
更新時間：2025年09月08日 16:29:48 作者：劉火鍋
Liquibase是開源數(shù)據(jù)庫版本管理工具,支持多數(shù)據(jù)庫及多格式變更日志,實現(xiàn)變更追蹤、上下文執(zhí)行、文檔生成等功能,需配置目錄結(jié)構(gòu)及master.xml文件,注意@PostConstruct初始化順序問題,建議用CommandLineRunner替代
數(shù)據(jù)庫版本管理
概述
Liquibase 是一個用于數(shù)據(jù)庫重構(gòu)、變更管理和版本控制的開源工具。
它通過對數(shù)據(jù)庫變更進行版本化管理，支持多人協(xié)作開發(fā)、多分支合并，并提供多種數(shù)據(jù)庫類型的支持。
特點
- 多數(shù)據(jù)庫支持：MySQL、PostgreSQL、Oracle、SQL Server、DB2、H2等
- 多格式變更日志：XML、YAML、JSON、SQL
- 上下文執(zhí)行邏輯：支持按需運行特定上下文變更
- 集群安全更新：確保分布式環(huán)境下的數(shù)據(jù)庫更新安全
- 變更文檔生成：自動生成數(shù)據(jù)庫修改文檔(HTML格式)
- 數(shù)據(jù)庫對比：使用命令對比兩個數(shù)據(jù)庫結(jié)構(gòu)差異
- 多平臺集成：支持命令行、Ant、Maven及應(yīng)用程序內(nèi)嵌
集成步驟
1. 添加依賴
<dependency>
<groupId>org.liquibase</groupId>
<artifactId>liquibase-core</artifactId>
</dependency>
2. 創(chuàng)建目錄結(jié)構(gòu)
在項目 resources 目錄下創(chuàng)建 liquibase 目錄用于存放 liquibase 相關(guān)的配置文件，在 liquibase 目錄下創(chuàng)建 changelog 目錄存放所有 changelog 文件
src/main/resources/
└── liquibase/
├── master.xml
└── changelog/
├── common/
│ ├── master.xml
│ └── 20230110_common_init_table.sql
└── other_module/
3.創(chuàng)建master.xml文件
在 liquibase 目錄下的 master.xml 為 liquibase 的入口，通過 include 標(biāo)簽將其它的 master.xml文件引入進來。
<?xml version="1.0" encoding="utf-8"?>
<databaseChangeLog
xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-3.4.xsd">
<!--
1：includeAll 標(biāo)簽可以把一個文件夾下的所有 changelog 都加載進來。如果單個加載可以用 include。
2：includeAll 標(biāo)簽里有兩個屬性：path 和 relativeToChangelogFile。
2.1：path （在 include 標(biāo)簽里是 file）：指定要加載的文件或文件夾位置
2.2：relativeToChangelogFile ：文件位置的路徑是否相對于 root changelog 是相對路徑，默認 false，即相對于 classpath 是相對路徑。
-->
<include file="liquibase/changelogs/common/master.xml"/>
</databaseChangeLog>
具體模塊的master.xml
<?xml version="1.0" encoding="utf-8"?>
<databaseChangeLog
xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-3.4.xsd">
<!--
1：includeAll 標(biāo)簽可以把一個文件夾下的所有 changelog 都加載進來。如果單個加載可以用 include。
2：includeAll 標(biāo)簽里有兩個屬性：path 和 relativeToChangelogFile。
2.1：path （在 include 標(biāo)簽里是 file）：指定要加載的文件或文件夾位置
2.2：relativeToChangelogFile ：文件位置的路徑是否相對于 root changelog 是相對路徑，默認 false，即相對于 classpath 是相對路徑。
-->
<changeSet id="liquibase/20230110_common_init_table.sql" author="xxxx">
<sqlFile path="liquibase/20230110_common_init_table.sql"/>
</changeSet>
</databaseChangeLog>
id：執(zhí)行id，執(zhí)行文件名稱
4. 應(yīng)用配置
指定 liquibase 的 changelog文件
spring:
liquibase:
enabled: false # 是否啟用
change-log: classpath:/liquibase/master.xml
changelog文件命名規(guī)則
- 文件名稱：日期_說明_data/table.xml
注意事項
初始化順序問題
問題描述：
- @PostConstruct注解的方法會在Liquibase之前執(zhí)行，如果這些方法需要訪問數(shù)據(jù)庫，會導(dǎo)致錯誤。
解決方案：
- 使用CommandLineRunner或ApplicationRunner接口替代@PostConstruct
總結(jié)
以上為個人經(jīng)驗，希望能給大家一個參考，也希望大家多多支持腳本之家。
相關(guān)文章
這篇文章主要介紹了解決jpa查詢語句自動變成了update的問題，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2021-08-08
Java利用Spire.PDF for Java實現(xiàn)將TXT轉(zhuǎn)換為PDF
在現(xiàn)代企業(yè)和個人開發(fā)中,文檔格式的轉(zhuǎn)換是一項常見且重要的任務(wù),本文將深入探討如何利用功能強大的Spire.PDF for Java庫,輕松實現(xiàn)Java中TXT到PDF的轉(zhuǎn)換,希望對大家有所幫助2025-11-11
本文主要介紹了Java項目打包為可執(zhí)行JAR的四種方法,包括IDE配置、Maven/Gradle插件、手動創(chuàng)建及依賴管理,具有一定的參考價值,感興趣的可以了解一下2025-08-08
在Java編程中,classpath是用于指定Java虛擬機在運行時查找類文件的路徑,本文主要介紹了java編譯時指定classpath的實現(xiàn)方法,具有一定的參考價值,感興趣的可以了解一下2023-10-10
Nacos-SpringBoot框架啟動不加載bootstrap.yml的解決
這篇文章主要介紹了Nacos-SpringBoot框架啟動不加載bootstrap.yml的解決方案，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2022-11-11
這篇文章主要為大家介紹了Seata?AT模式前后鏡像是如何生成的方法詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步，早日升職加薪2022-11-11
SpringBoot結(jié)合Neo4j自定義cypherSql的方法
這篇文章主要介紹了SpringBoot結(jié)合Neo4j自定義cypherSql,本文通過實例代碼給大家介紹的非常詳細，對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值，需要的朋友可以參考下2021-11-11
這篇文章主要介紹了mybatis返回結(jié)果為Map問題,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2025-04-04
這篇文章主要介紹了idea無法切換分支報錯問題及解決方案，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2023-03-03
SpringBoot+MyBatis整合ClickHouse實踐記錄
本文介紹了如何使用SpringBoot、MyBatis和ClickHouse整合,包括添加依賴、配置數(shù)據(jù)源、創(chuàng)建實體類、Mapper接口、服務(wù)層和控制器的步驟,通過這些步驟,可以使Java應(yīng)用程序高效地與ClickHouse數(shù)據(jù)庫進行交互,感興趣的朋友跟隨小編一起看看吧2024-12-12