Liquibase 数据库变更管理快速上手指南5 分钟跑通第一次数据库迁移【免费下载链接】liquibaseMain Liquibase Source项目地址: https://gitcode.com/GitHub_Trending/li/liquibaseLiquibase 是一款广泛使用的开源数据库变更管理工具。它让数据库结构改动像代码一样被版本化管理把变更写进变更日志changelog文件用一条命令执行每次执行的记录都会留在数据库里。本指南面向新手读完后你能跑通第一次数据库迁移并看懂这个项目源码的布局快速进入 Liquibase 新手友好的学习路径。 告别散乱的 SQL 脚本Liquibase 解决什么问题这一节用三句话回答为什么你需要这个工具。传统做法是直接往数据库里执行 SQL。谁在什么时候改了什么很快没人说得清。团队成员各自手里是一份不同版本的脚本上线时很容易漏掉某一步。Liquibase 把每次改动写进 changelog 文件里的一个 changeSet自动排好执行顺序把执行记录写进数据库还能回滚。它的存在意义就一句话让数据库结构变得可版本化、可追溯、可复现。✅ 跑起来之前需要准备什么这一节列清楚前置条件照着检查一遍就能开工。终端和文本编辑器你需要执行命令、改两个 XML 文件。Docker仓库自带示例用它跑最省事。如果你打算编译源码仓库是多模块 Maven 工程根 pom.xml 要求 Java 17 及以上。不编译可以跳过这条。clone 仓库如果本地没有的话git clone https://gitcode.com/GitHub_Trending/li/liquibase 第一次运行5 分钟跑通第一个迁移这一节给你最短的上手路径零额外配置。仓库在 docker/examples/docker-compose/ 放了一个现成示例起一个 PostgreSQL 容器Liquibase 容器自动连上去执行两个 changeSet——建一张 users 表再插入两条样例数据。进目录执行这条命令即可cd liquibase/docker/examples/docker-compose docker compose up执行完你会看到终端日志里 Liquibase 连上数据库2 个 changeSets 执行成功并打印一份 UPDATE SUMMARY。此时数据库里已经有 users 表和两条数据了示例已经跑通。 核心目录导览只记住这几处这一节告诉你东西都在哪免得一上来就从头读源码。liquibase-standard/核心源码。变更日志解析changelog 包、变更定义change 包、SQL 生成sqlgenerator 包、数据库快照snapshot 包都在这。liquibase-cli/命令行入口。你在终端敲的 liquibase 命令最终就是在这里被解析和执行的。liquibase-maven-plugin/Maven 集成插件让项目能用 mvn 命令跑迁移。liquibase-dist/发行打包模块产出可下载的发行包。docker/Docker 镜像构建脚本和刚才跑过的示例。其余模块liquibase-core、liquibase-integration-tests、liquibase-snowflake 等负责依赖聚合、集成测试和 Snowflake 适配新手阶段可以先不碰。⚙️ 关键配置逐项拆解properties 文件里的 5 个行为开关这一节带你逐行看示例配置看完你就能为任意数据库写一份自己的配置。示例配置在 docker/examples/docker-compose/liquibase.properties一共 5 项每项都直接影响行为changeLogFiledb.changelog-master.xml变更日志的入口文件Liquibase 从它开始读所有变更。urljdbc:postgresql://postgres:5432/liquibase_demo目标数据库的 JDBC 地址postgres 是数据库容器的服务名。username / password登录数据库的账号密码与 PostgreSQL 初始化时一致。driverorg.postgresql.Driver告诉 Liquibase 使用哪个数据库驱动。searchPath/liquibase/changelog查找 changelog 文件的目录子文件靠它定位。一个细节示例的 docker-compose.yml 里还通过 LIQUIBASE_COMMAND_URL 等环境变量传了同样的连接信息。两种方式等价生产环境更常用环境变量传敏感信息避免明文写进文件。 一个典型场景走一遍从建表到插入数据这一节把示例的两个文件拆开走一遍理解完 changelog 的心智模型就通了。入口文件 db.changelog-master.xml 用 include 标签按顺序引用两个子文件执行顺序就是书写顺序。第一个 changeSet 在 001-create-users-table.xml 里id 为 1。内容是 createTable建 users 表含 id自增主键、username、email都唯一非空、created_at 四列。第二个 changeSet 在 002-insert-sample-data.xml 里id 为 2向表中插入两条记录。每个 changeSet 都有唯一 id 和 author。执行后Liquibase 会在数据库里记一条执行记录并算出内容校验和checksum。下次再执行 update 时已跑过的 changeSet 会被跳过。这就是同一条命令可以反复跑而不报错的底层机制。❓ 新手常见疑问4 个高频问题这一节回答新手最容易卡住的四个问题。问已经执行过的 changelog 文件内容还能改吗不建议。changeSet 内容一变校验和就对不上下次 update 会直接报错。正确做法永远是新增一个 changeSet而不是改旧的。问Liquibase 会在我的数据库里建什么表两张DATABASECHANGELOG 记录已执行的 changeSetDATABASECHANGELOGLOCK 是锁表防止多个进程同时执行迁移。问只想看会执行什么 SQL不想真跑可以吗可以。把 update 换成 updateSQL它会打印出全部待执行 SQL但一条都不执行适合上线前预览。问除了 PostgreSQL还能连别的数据库吗可以。MySQL、Oracle、MSSQL 等都在支持范围内改 url 和 driver、并引入对应驱动即可。注意 Liquibase 5.0 起社区版不再默认捆绑驱动需要用 lpm add 命令单独添加。 下一步可以做什么这一节给你两个低成本的深入方向。写一个自己的 changeSet照着 001 文件新建一个 changeSet写个简单的 createTable再执行一次 update亲手体验记录—执行闭环。之后可以试试给 changeSet 加 rollback 逻辑体验撤销一次变更。如果你还想看源码从 liquibase-standard/src/main/java/liquibase/changelog/ 开始ChangeSet 和 DatabaseChangeLog 这两个类是整个系统的骨架。一句话总结Liquibase 把数据库结构从会漂移的东西变成被管理的东西。当你习惯把改动写进 changelog你的数据库就不会再失控。【免费下载链接】liquibaseMain Liquibase Source项目地址: https://gitcode.com/GitHub_Trending/li/liquibase创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考