Liquibase 数据库版本管理工具：3. changeSet 变更集详解

上篇文章中详细了介绍了一下changelog 文件的使用，本篇文章将详细说一下 changeSet 变更集 中的细节，以及通常的使用方式

1.变更集分类

changeSet 分为 6类：

• add
• create
• drop
• rename
• sql
• other

官方文档：https://docsstage.liquibase.c...，每一个标签都有其必须的参数，使用时根据情况自行设定即可

用法均为如下格式：

<changeSet>
    <xxxx />
</changeSet>

2.1 add

标签	描述
addAutoIncrement	将一个已存在的列转换为自增
addColunm	增加列
addDefaultValue	对已存在的列增加默认值
addForeignKeyConstraint	对已存在的列增加外键约束
addLookupTable	创建外键关联的表
addNotNullConstraint	对已存在的列增加非空约束
addPrimaryKey	对已存在的列增加主键约束
ddUniqueConstraint	对已存在的列增加主键约束

2.2 create

标签	描述
createIndex	创建索引
createProcedure	创建存储过程
createSequence	创建序列
createTable	创建表
createView	创建视图

2.3 drop

标签	描述
dropAllForeignKeyConstraints	删除全部的外键约束
dropColumn	删除列
dropDefaultValue	删除默认值设置
dropForeignKeyConstraint	删除某一列的外键约束
dropNotNullConstraint	删除非空约束
dropIndex	删除索引
dropSequence	删除约束
dropProcedure	删除存储过程
dropPrimaryKey	删除主键
dropTable	删除表
dropUniqueConstraint	删除唯一性约束
dropView	删除视图

2.4 rename

标签	描述
renameColumn	重命名列
renameSequence	重命名序列
renameTable	重命名表
renameView	重命名视图

2.5 sql

标签	描述
sql	原生SQL
sqlFile	引入 SQL 文件

2.6 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	更新数据

2.常用变更集

上面这么多的标签，相信已经将很多人的眼睛看花了，不要紧，将它们全部罗列出主要还是想大家能够对 Liquibase 有一个更全面的理解，遇到某些场景时能够对症检索。

接下来我会介绍几个常用的标签，基本能够覆盖大多数场景。

2.1 SQL

最常用以及最顺手的就是 sql 标签，开发人员像使用 Mybatis 一样，写原生SQL，但是如果SQL比较复杂，可读性就不怎么好

<changeSet id="xxxx" author="jiaotd" labels="init" >
        <sql>
            USE `db_xxx`;
              insert into table_t values(1,1,1);
        </sql>
 </changeSet>

2.2 sqlFile

sqlFIle 就是将上面 SQL 中的语句单独使用文件存储，在 sqlFIle 引入。

这样做的好处是 changelog 文件简单、整洁、可读性高、易于维护。

 <changeSet id="xxxx" author="jiaotd" labels="init" >
    <sqlFile path="update/xxxx.sql" relativeToChangelogFile="true"/>
 </changeSet>

2.3 loadData

loadData 通常用于导入数据，一般我们用于系统升级时导入大量的数据。

<changeSet  author="jiaotd"  id="loadData-xxx">  
    <loadData commentLineStartsWith="//"  
            encoding="UTF-8"  
            file="example/users.csv"  
            quotchar="'"  
            relativeToChangelogFile="true"  
            schemaName="public"  
            separator=";"  
            tableName="person"  
            usePreparedStatements="true">  
        <column  header="header1"  
                name="id"  
                type="NUMERIC"/>  
        <column  index="3"  
                name="name"  
                type="BOOLEAN"/>  
    </loadData>  
</changeSet>