Liquibase 快速入門指南一篇文章看懂?dāng)?shù)據(jù)庫(kù)變更管理的核心文件與啟動(dòng)方式【免費(fèi)下載鏈接】liquibaseMain Liquibase Source項(xiàng)目地址: https://gitcode.com/GitHub_Trending/li/liquibaseLiquibase 是一款專注于數(shù)據(jù)庫(kù)變更管理的開源工具它的使命很樸素讓數(shù)據(jù)庫(kù)結(jié)構(gòu)的每一次改動(dòng)都像代碼一樣可以被記錄、被審查、被回滾。如果你經(jīng)歷過(guò)這個(gè)表到底是誰(shuí)加的字段測(cè)試庫(kù)和線上庫(kù)結(jié)構(gòu)怎么又對(duì)不上了這類讓人頭大的時(shí)刻這篇文章就是為你準(zhǔn)備的。我會(huì)從它解決的問(wèn)題講起帶你認(rèn)識(shí)倉(cāng)庫(kù)里的關(guān)鍵文件、啟動(dòng)方式和配置要點(diǎn)讓新手也能快速上手。Liquibase 到底在解決什么問(wèn)題用一句話概括Liquibase 相當(dāng)于數(shù)據(jù)庫(kù)的版本管理工具。想想你平時(shí)怎么管理代碼——提交、對(duì)比、回滾、協(xié)作Liquibase 把這一整套思路搬到了數(shù)據(jù)庫(kù)上把每一次結(jié)構(gòu)變更寫成一條條變更集changeSet誰(shuí)改的、改了什么、什么時(shí)候改的一清二楚自動(dòng)為所有變更腳本排序在目標(biāo)數(shù)據(jù)庫(kù)上按正確順序執(zhí)行不用自己操心依賴關(guān)系需要反悔時(shí)一條命令就能回滾之前的改動(dòng)可以無(wú)縫融入 Maven、Gradle、Spring Boot 以及各種 CI/CD 流程成為團(tuán)隊(duì)協(xié)作的一部分想了解它是怎么做到的最直接的辦法就是打開它的源碼倉(cāng)庫(kù)從頭構(gòu)建一次。從克隆到構(gòu)建用 mvnw 兩步跑起來(lái)很多人拿到新項(xiàng)目的第一反應(yīng)是先裝個(gè) Maven其實(shí)完全沒必要。倉(cāng)庫(kù)里帶了兩個(gè)特殊的啟動(dòng)腳本mvnwLinux/macOS 用和mvnw.cmdWindows 用。它們叫Maven Wrapper會(huì)自動(dòng)下載項(xiàng)目指定版本的 Maven 并執(zhí)行命令省去了手動(dòng)安裝和版本不匹配的煩惱。克隆并構(gòu)建項(xiàng)目git clone https://gitcode.com/GitHub_Trending/li/liquibase cd liquibase ./mvnw compileWindows 用戶把最后一步換成mvnw.cmd compile即可。構(gòu)建成功后你就擁有了一個(gè)完整的 Liquibase 社區(qū)版源碼環(huán)境。整個(gè)工程由多個(gè)模塊組成命令行、核心庫(kù)、Maven 插件等而mvnw會(huì)按根pom.xml的定義把它們組織起來(lái)這也是接下來(lái)要說(shuō)的重點(diǎn)。三份關(guān)鍵文件看懂 Liquibase 的運(yùn)行邏輯pom.xml項(xiàng)目的中樞神經(jīng)根目錄的pom.xml是 Maven 項(xiàng)目對(duì)象模型文件定義了整個(gè)工程的依賴、插件和構(gòu)建方式。比如它要求使用 Java 17 和 Maven 3.6 以上版本并把liquibase-standard、liquibase-cli、liquibase-maven-plugin等子模塊串聯(lián)成一個(gè)整體。想了解項(xiàng)目用什么語(yǔ)言、依賴了哪些庫(kù)、如何打包發(fā)布答案幾乎都在這里。liquibase.properties數(shù)據(jù)庫(kù)連接信息都在這里真正運(yùn)行 Liquibase 時(shí)你會(huì)頻繁和它打交道。這是一份典型的配置示例changeLogFiledb.changelog-master.xml urljdbc:postgresql://postgres:5432/liquibase_demo usernameliquibase passwordliquibase_password driverorg.postgresql.Driver searchPath/liquibase/changelog字段非常直白u(yù)rl是數(shù)據(jù)庫(kù)連接串username和password是賬號(hào)密碼changeLogFile指向變更日志入口文件searchPath告訴它去哪里找變更文件。新手照著改前幾項(xiàng)就能連上自己的數(shù)據(jù)庫(kù)。changelog 目錄數(shù)據(jù)庫(kù)變更的劇本變更日志是 Liquibase 的核心概念。倉(cāng)庫(kù)的示例里一個(gè)db.changelog-master.xml作為總?cè)肟谟胕nclude把多個(gè)變更文件串起來(lái)databaseChangeLog ... include file001-create-users-table.xml relativeToChangelogFiletrue/ include file002-insert-sample-data.xml relativeToChangelogFiletrue/ /databaseChangeLog而每一個(gè)變更文件里是一條條帶id和author的 changeSet。比如創(chuàng)建用戶表的變更集長(zhǎng)這樣changeSet id1 authordocker-compose-example createTable tableNameusers column nameid typeSERIAL autoIncrementtrue constraints primaryKeytrue nullablefalse/ /column column nameusername typeVARCHAR(50) constraints nullablefalse uniquetrue/ /column /createTable /changeSet 理解這個(gè)結(jié)構(gòu)就夠了主文件負(fù)責(zé)編排變更文件負(fù)責(zé)描述每一步要做什么。Liquibase 會(huì)記住哪些變更集已經(jīng)執(zhí)行過(guò)下次只執(zhí)行新增的部分。倉(cāng)庫(kù)全景源碼、示例與自動(dòng)化流水線除了上面三份關(guān)鍵文件倉(cāng)庫(kù)里還有很多值得新手認(rèn)識(shí)的角落liquibase-standard、liquibase-core核心邏輯所在Java 源碼都放在各模塊的src/main/java下liquibase-cli命令行入口日常用liquibase update之類的命令就靠它liquibase-maven-plugin讓 Maven 構(gòu)建和數(shù)據(jù)庫(kù)遷移合二為一docker/examples現(xiàn)成的示例比如docker-compose目錄里配好了一個(gè) PostgreSQL 加 Liquibase 的完整演示環(huán)境.github/workflows項(xiàng)目的 CI/CD 流水線負(fù)責(zé)自動(dòng)化測(cè)試和發(fā)布scripts一些輔助腳本如 Docker 鏡像矩陣生成腳本README.md、LICENSE.txt、.gitignore說(shuō)明文檔、許可證和 Git 忽略規(guī)則開項(xiàng)目前先掃一眼總沒錯(cuò)項(xiàng)目的持續(xù)集成相當(dāng)規(guī)范每次代碼合并后會(huì)自動(dòng)跑測(cè)試還會(huì)通過(guò) dry-run 流程模擬發(fā)布再把手里的制品分發(fā)到不同的存儲(chǔ)渠道。下圖就是發(fā)布流程中 dry-run 的可視化界面可以看到整個(gè)流程被拆成了清晰的步驟構(gòu)建出來(lái)的安裝包、鏡像和 jar 包最終會(huì)發(fā)布到各類制品倉(cāng)庫(kù)。例如把.deb、.rpm等格式的安裝文件放到對(duì)象存儲(chǔ)桶里供用戶下載對(duì)普通使用者來(lái)說(shuō)這些流水線不用深究但它們恰好說(shuō)明了 Liquibase 生態(tài)的成熟度——每個(gè)改動(dòng)都經(jīng)過(guò)自動(dòng)化驗(yàn)證才敢放心發(fā)布給全球用戶。給新手的三個(gè)避坑提醒別手動(dòng)改數(shù)據(jù)庫(kù)里的DATABASECHANGELOG表。這張表記錄著哪些變更集執(zhí)行過(guò)動(dòng)它會(huì)導(dǎo)致 Liquibase 認(rèn)為變更沒執(zhí)行引發(fā)重復(fù)執(zhí)行或校驗(yàn)失敗。已經(jīng)執(zhí)行過(guò)的 changeSet 不要改內(nèi)容。Liquibase 會(huì)給每個(gè)變更集生成 checksum 校驗(yàn)值內(nèi)容變了會(huì)對(duì)不上直接報(bào)錯(cuò)。正確的做法是新增一個(gè) changeSet 來(lái)描述新的改動(dòng)。先預(yù)覽再執(zhí)行。正式執(zhí)行前先用updateSql查看將要生成的 SQL確認(rèn)無(wú)誤后再執(zhí)行update。別在生產(chǎn)庫(kù)上直接試錯(cuò)。??下一步可以做什么如果你已經(jīng)把這篇讀到這里說(shuō)明你離上手只差一步了。建議先去docker/examples/docker-compose目錄跑一遍示例親手改幾個(gè) changelog 文件、執(zhí)行幾次update和rollback很快就能體會(huì)到數(shù)據(jù)庫(kù)變更也能版本化的爽快感。等熟悉了這套流程再回頭研究源碼里更高級(jí)的特性比如上下文contexts、標(biāo)簽labels和自定義前置條件你的數(shù)據(jù)庫(kù)變更管理工作就會(huì)越來(lái)越順手?！久赓M(fèi)下載鏈接】liquibaseMain Liquibase Source項(xiàng)目地址: https://gitcode.com/GitHub_Trending/li/liquibase創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考