一、执行入口
springboot项目通过LiquibaseAutoConfiguration
自动装配SpringLiquibase。
SpringLiquibase实现了InitializingBean
接口。bean初始化后开始执行afterPropertiesSet
方法。方法中包含创建liquibase实例,生成版本回滚文件,根据配置文件执行数据库变更的操作。
二、Liquibase实例的创建。
Liquibase实例创建过程中判断是否需要先删除数据库表的操作。判断依据是spring的配置spring.liquibase.drop-first=true
。默认为false,慎用该功能,如果表里有数据那可都没有。虽然删除前会备份一下,但还是停麻烦的。
三、生成版本回滚文件
在引入jar项目的使用中,liquibase不执行回滚操作。所以不用怀疑liquibase为什么不回顾,因为他就是不支持你回滚,只是帮你生成了一个可执行回滚的sql文件。如果需要直接回滚可以使用liquibase命令工具。
是否生成回滚文件依赖的判断配置是spring.liquibase.rollback-file=classpath:rollback.sql
,并且这个配置文件rollback.sql必须得存在。
liquibase的回滚可依据版本号进行,遗憾的是LiquibaseAutoConfiguration没有进行版本号配置,如果需要的话要开发者自己装配实现吧。所以默认生成的回滚文件的内容取自changSet的rollback节点,并且这里的changeSet必须是这次更新前未执行过的。就是说是这次更新增量的回滚文件。如需回滚拿着这个回滚sql文件手动执行吧。
四、更新回滚前的准备工作
更新回滚前都会进行一些校验性的工作。
- 解析changeLog
- 校对并验证
databasechangelog
表是否存在,字段是存在,是否正确,不存在则新增,不正确则修改。 - 校对并验证
databasechangelogLock
表是否存在,字段是存在,是否正确,不存在则新增,不正确则修改。 - 检查文件的
preconditions
是否正确。 - 检查changeSet的md5是否正确,如果是更新操作前的校验则会检测md5版本是否和当前liquibase一致,如果不一致则会清空,为md5版本兼容做准备,生成回滚文件前只做校对,不在修改。
五、liquibase根据配置文件执行数据库变更操作
更新操作根据spring的配置spring.liquibase.test-rollback-on-update=
是true还是false分2种情况。
- 配置为false时(默认)。直接执行数据库变更操作,当然更新前的校验性工作肯定也是必须的。
- 配置为true时。先执行数据库变更操作,然后回滚至更新前的状态,最后再执行数据库变更操作。通过变更-回滚-再变更进行回滚校验操作。
六、数据库变更操作
- 检测changeSet是否被执行过,根据
databasechangelog
表中的记录确定查询关键字id
和author
;- 如果未执行过,执行changeSet
- 如果已执行过,检测md5是否一致
- md5一致,跳过changeSet
- md5不一致,抛异常,如果因为版本原因检测的时候已经将md5纠正
liquibase就是靠以上逻辑控制数据库变更的版本控制。可以从任意的低版本升级到高版本的数据库内容,并且支持回滚。
liquibase 的执行逻辑及相关配置讲完了,下一节将将到liquibase使用技巧及最佳实践。欲知详情如何,且听下回分解。