Liquibase 和 Flyway 是两款成熟的、优秀的、开源/商业版的数据库版本管理工具,鉴于 Flyway 的社区版本对 Oracle 数据库支持存在限制,所以 boot-admin 选择整合 Liquibase 提供数据库版本管理能力支持。
Liquibase 开源版使用 Apache 2.0 协议。
Liquibase的适用情形?
- 在你的项目进行版本升级的时候,大概率情况下数据库也需要同步升级,Liquibase 会自动扫描数据库迁移文件(changeSet),将迁移文件的版本号与历史记录表(changelog )中的版本号进行对比,略过已执行的的迁移文件,顺序执行未执行的新版本迁移文件,最终实现数据库与代码版本相匹配;
- 当多人协作开发项目的时候,系统源代码可使用 git 保持同步,那么数据库的同步就可交由 liquibase 来保证;
- 使用 liquibase 可以方便地比较两个数据库的差异;
- 使用 liquibase 还支持数据库版本回滚。
Liquibase的优点有哪些?
- 配置文件支持SQL、XML、JSON 或者 YAML;
- 可兼容14种主流数据库如 oracle,mysql 等,支持平滑迁移;
- 版本控制按序执行;
- 可以用上下文控制sql在何时何地如何执行;
- 具备在应用中具有if / then逻辑的能力;
- 支持 schema 的变更;
- 根据配置文件自动生成sql语句用于预览;
- 可重复执行迁移;
- 可插件拓展;
- 可回滚;
- 支持schema方式的多租户(multi-tenant);
- 能够在多种数据库类型上具有相同的更改描述;
- 生成的数据库历史记录文档;
- 能够轻松指定更复杂的多语句更改。
整合要点
boot-admin 是一款采用前后端分离模式、基于 SpringCloud 微服务架构的SaaS后台管理框架。系统内置基础管理、权限管理、运行管理、定义管理、代码生成器和办公管理6个功能模块,集成分布式事务 Seata、工作流引擎 Flowable、业务规则引擎 Drools、后台作业调度框架 Quartz 等,技术栈包括 Mybatis-plus、Redis、Nacos、Seata、Flowable、Drools、Quartz、SpringCloud、Springboot Admin Gateway、Liquibase、jwt、Openfeign、I18n等。
项目源码仓库github
项目源码仓库gitee
引入Maven依赖
org.liquibase
liquibase-core
添加配置
spring:
liquibase:
enabled: true
change-log: classpath:liquibase/master.xml
创建master.xml
在 resources 下创建文件夹 liquibase ,创建文件 master.xml
在 liquibase 文件夹下创建 changelogs 和 sql 两个文件夹,如下图所示:
编写数据库变更单元 changeSet
在 resourcesliquibasechangelogs 下创建 changeSet 文件,推荐每月一个 xml 文件,文件名格式:【changelog-年度+月份.xml】,如:changelog-202304.xml
常用操作举例:
创建表
添加表字段
删除表字段
修改表字段说明
修改表字段类型
创建视图
CREATE OR REPLACE FORCE VIEW V_TABLES_MASTER (TABLE_SCHEMA, TABLENAME, TABLETYPE, COMMENTS, TENANT_ID_) AS
select SYS_CONTEXT('USERENV','CURRENT_SCHEMA') TABLE_SCHEMA,
t.tname tableName,
tabtype tabletype,
f.comments comments,
'DEMO' TENANT_ID_
from tab t
inner join user_tab_comments f
on t.tname = f.table_name
where tname != 'DATABASECHANGELOG'
and tname != 'DATABASECHANGELOGLOCK'
and tname != 'UNDO_LOG'
CREATE OR REPLACE VIEW V_TABLES_MASTER AS
SELECT
TABLE_SCHEMA,
TABLE_NAME AS TABLENAME,
case when table_type='BASE TABLE' then 'TABLE' ELSE table_type END AS TABLETYPE,
TABLE_COMMENT AS COMMENTS,
'DEMO' TENANT_ID_
FROM
information_schema.`TABLES`
WHERE table_name != 'databasechangeloglock' AND TABLE_NAME != 'databasechangelog' AND TABLE_NAME != 'undo_log'
兼容 Oracle 和 Mysql 配置
执行 SQL 文件
需将对应 sql 文件放在指定文件夹中。
Liquibase changeSet常用命令清单
add
标签 | 描述 |
---|---|
addAutoIncrement | 将一个已存在的列转换为自增 |
addColunm | 增加列 |
addDefaultValue | 对已存在的列增加默认值 |
addForeignKeyConstraint | 对已存在的列增加外键约束 |
addLookupTable | 创建外键关联的表 |
addNotNullConstraint | 对已存在的列增加非空约束 |
addPrimaryKey | 对已存在的列增加主键约束 |
ddUniqueConstraint | 对已存在的列增加主键约束 |
create
标签 | 描述 |
---|---|
createIndex | 创建索引 |
createProcedure | 创建存储过程 |
createSequence | 创建序列 |
createTable | 创建表 |
createView | 创建视图 |
drop
标签 | 描述 |
---|---|
dropAllForeignKeyConstraints | 删除全部的外键约束 |
dropColumn | 删除列 |
dropDefaultValue | 删除默认值设置 |
dropForeignKeyConstraint | 删除某一列的外键约束 |
dropNotNullConstraint | 删除非空约束 |
dropIndex | 删除索引 |
dropSequence | 删除约束 |
dropProcedure | 删除存储过程 |
dropPrimaryKey | 删除主键 |
dropTable | 删除表 |
dropUniqueConstraint | 删除唯一性约束 |
dropView | 删除视图 |
rename
标签 | 描述 |
---|---|
renameColumn | 重命名列 |
renameSequence | 重命名序列 |
renameTable | 重命名表 |
renameView | 重命名视图 |
sql
标签 | 描述 |
---|---|
sql | 原生SQL |
sqlFile | 引入 SQL 文件 |
other
标签 | 描述 | 标签 | 描述 |
---|---|---|---|
alterSequence | 修改序列 | customChange | 自定义change类型,需要自己实现liquibase.change.custom.CustomSqlChange、liquibase.change.custom.CustomTaskChange接口 |
delete | 删除数据 | empty | 空操作 |
executeCommand | 执行系统命令,如 mysqldump | insert | 插入数据 |
loadData | 加载 csv 文件到已存在的表中 | loadUpdateData | 加载 csv 文件到已存在的表中,但是会判断是否存在,存在更新,否则新增 |
mergeColumns | 将两列值合并在一起,存入新列中 | modifyDataType | 修改列数据类型 |
output | 记录一条消息并继续执行 | setColumnRemarks | 列上添加备注 |
setTableRemarks | 表上添加备注 | stop | 通过消息停止 Liquibase |
tagDatabase | 将标签应用于数据库以供将来回滚 | update | 更新数据 |
服务器托管,北京服务器托管,服务器租用 http://www.fwqtg.net
机房租用,北京机房租用,IDC机房托管, http://www.e1idc.net