liquibase使用教程
在项目中引入liquibase过程：
1、父项目 pom.xml 中添加依赖
<dependencies> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>5.1.30</version> </dependency> <dependency> <groupId>org.liquibase</groupId> <artifactId>liquibase-core</artifactId> <version>3.5.5</version> </dependency> </dependencies>
2、添加liquibase.properties文件
#liquibase changeLogFile=src/main/resources/liquibase/db.changelog-master.xml driver=com.mysql.jdbc.Driver url=jdbc:mysql://localhost:3306/test?useUnicode=true&characterEncoding=utf-8 username=root password=egova
3、父项目 pom中添加liquibase插件
<build> <plugins> <plugin> <groupId>org.liquibase</groupId> <artifactId>liquibase-maven-plugin</artifactId> <version>3.5.1</version> <configuration> <!--properties文件路径，该文件记录了数据库连接信息等--> <propertyFile>src/main/resources/liquibase.properties</propertyFile> <propertyFileWillOverride>true</propertyFileWillOverride> <!--生成文件的路径--> <outputChangeLogFile>src/main/resources/liquibase/changelog_dev.xml</outputChangeLogFile> <!-- <driver>com.mysql.jdbc.Driver</driver> <url>jdbc:mysql://localhost:3306/test?useUnicode=true&characterEncoding=utf-8</url> <username>root</username> <password>egova</password>--> </configuration> </plugin> </plugins> </build>
4、新建changelog主文件入口： db.changelog-master.xml
<?xml version="1.0" encoding="UTF-8"?> <databaseChangeLog xmlns="http://www.liquibase.org/xml/ns/dbchangelog" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-3.1.xsd"> <include file="src/main/resources/liquibase/changelog_dev.xml"/> <!-- <include file="com/example/db/changelog/db.changelog-1.1.xml"/> <include file="com/example/db/changelog/db.changelog-2.0.xml"/>--> </databaseChangeLog>
5、打开maven命令框：可以选择模块
6、生成changelog
liquibase:generateChangeLog
（1） 对当前数据库状态生成 changlog：
mvn liquibase:generateChangeLog
（2）只对数据生成 changelog ，（先用别的方式往数据库创建数据后再用此方式生成changelog）
mvn liquibase:generateChangeLog -Dliquibase.diffTypes=data
区别：前者是在changelog中追加表创建语句，生成建表语句和数据插入语句，如果表语句已存在，则只生成建表语句：如图
<?xml version="1.1" encoding="UTF-8" standalone="no"?> <databaseChangeLog xmlns="http://www.liquibase.org/xml/ns/dbchangelog" xmlns:ext="http://www.liquibase.org/xml/ns/dbchangelog-ext" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog-ext http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-ext.xsd http://www.liquibase.org/xml/ns/dbchangelog http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-3.5.xsd"> <changeSet author="zhaoyanhao" id="1565662890214-1" objectQuotingStrategy="QUOTE_ALL_OBJECTS"> <createTable tableName="test1"> <column name="id" type="BIGINT"> <constraints nullable="false"/> </column> <column name="name" type="VARCHAR(15)"> <constraints nullable="false"/> </column> <column name="email" type="VARCHAR(100)"> <constraints nullable="false"/> </column> <column name="password" type="VARCHAR(8)"> <constraints nullable="false"/> </column> <column name="phone" type="VARCHAR(50)"> <constraints nullable="false"/> </column> <column name="address" type="VARCHAR(255)"> <constraints nullable="false"/> </column> <column name="description" type="LONGTEXT"/> <column defaultValueComputed="CURRENT_TIMESTAMP" name="create_time" type="TIMESTAMP"> <constraints nullable="false"/> </column> </createTable> </changeSet> <changeSet author="zhaoyanhao" id="1565662890214-2" objectQuotingStrategy="QUOTE_ALL_OBJECTS"> <addPrimaryKey columnNames="id" constraintName="PRIMARY" tableName="test1"/> </changeSet> <changeSet author="zhaoyanhao" id="1565662890214-3" objectQuotingStrategy="QUOTE_ALL_OBJECTS"> <createTable tableName="test2"> <column name="id" type="BIGINT"> <constraints nullable="false"/> </column> <column name="name" type="VARCHAR(15)"> <constraints nullable="false"/> </column> <column name="password" type="VARCHAR(8)"> <constraints nullable="false"/> </column> <column name="phone" type="VARCHAR(50)"> <constraints nullable="false"/> </column> <column name="address" type="VARCHAR(255)"> <constraints nullable="false"/> </column> <column name="description" type="LONGTEXT"/> <column defaultValueComputed="CURRENT_TIMESTAMP" name="create_time" type="TIMESTAMP"> <constraints nullable="false"/> </column> </createTable> </changeSet> <changeSet author="zhaoyanhao" id="1565662890214-4" objectQuotingStrategy="QUOTE_ALL_OBJECTS"> <addPrimaryKey columnNames="id" constraintName="PRIMARY" tableName="test2"/> </changeSet> </databaseChangeLog>
7、执行changelog，写入数据库
在changeset中添加createTable语句，执行liquibase，使用命令：
liquibase:update 将changelog变化的内容写入数据库
liquibase:updateSQL 检查changelog语法的合法性
8、在项目中使用liquibase
@Bean public SpringLiquibase liquibase(DataSource dataSource, LiquibaseProperties liquibaseProperties) { SpringLiquibase liquibase = new SpringLiquibase(taskExecutor, env); liquibase.setDataSource(dataSource); //制定changelog的位置，这里使用的一个master文件引用其他文件的方式 liquibase.setChangeLog("classpath:config/liquibase/db.changelog-master.xml"); liquibase.setContexts(liquibaseProperties.getContexts()); liquibase.setDefaultSchema(liquibaseProperties.getDefaultSchema()); liquibase.setDropFirst(liquibaseProperties.isDropFirst()); return liquibase; }
第三方调用liquibase可以参考：https://blog.csdn.net/weixin_34087307/article/details/91397914
liquibase命令大全
| 命令名称 | 命令描述 |
|---|---|
| update | 更新数据库到当前版本 |
| updateSQL | 写入SQL将数据库更新到currentversion或STDOUT |
| updateCount <num> | 将下一个NUM更改应用到数据库 |
| updateCountSQL <num> | 写入SQL以将下一个NUM更改应用到数据库 |
| updateToTag <tag> | 使用指定的标记将数据库更新到变更集 |
| updateToTagSQL <tag> | 使用指定的标记将SQL写入(到标准输出)到更改集 |
| rollback <tag> | 将数据库回滚到指定标签的状态is was |
| rollbackSQL <tag> | 生成数据库回滚到指定标签的sql |
| rollbackToDate <date/time> | 将数据库回滚到给定日期/时间的状态is was。日期格式:yyyy-MM-dd 'HH: mm: ss |
| rollbackToDateSQL <date/time> | 写入SQL以将数据库回滚到给定日期/时间版本的状态到STDOUT |
| rollbackCount <value> | 回滚应用于数据库的最后一个<值>更改集 |
| rollbackCountSQL <value> | 写入SQL以回滚最后一个<值>更改集到应用于数据库的stdoutapply |
| futureRollbackSQL | 写入SQL，以便在更改日志中的更改完成后将数据库回滚到当前状态 |
| futureRollbackSQL <value> | 在更改日志中的<值>更改完成后，写入SQL以将数据库回滚到当前状态 |
| futureRollbackFromTagSQL <tag> | 写入(到标准输出)SQL，以便在更改后将数据库回滚到其当前状态 |
| updateTestingRollback | 更新数据库，然后再次回滚更改。用于测试回滚支持 |
| generateChangeLog | 写入更改日志XML以将数据库的当前状态复制到标准输出 |
| snapshot | 将数据库的当前状态写入标准输出 |
| snapshotReference | 将referenceUrl数据库的当前状态写入标准输出 |
| Diff Commands | 数据库对比命令 |
| diff [diff parameters] | 数据库对比命令 |
| diffChangeLog [diff parameters] | 数据库对比日志 |
| Documentation Commands | 文档命令 |
| dbDoc <outputDirectory> | 基于当前数据库和更改日志生成类似javadoc的文档 |
| Maintenance Commands | 维护命令 |
| tag <tag string> | 给当前的数据库打标签，方便日后回滚 |
| tagExists <tag string> | 检查对应的标签是否存在 |
| status [--verbose] | 输出为执行changeset的行数 |
| unexpectedChangeSets[--verbose] | 输出本地不存在changeset 行数 |
| validate | 检查是否有错误的changelog |
| calculateCheckSum <id> | 检查指定changeset id 的checksum值 格式为 filepath::id::author |
| clearCheckSums | 从数据库日志中删除所有保存的校验和 |
| changelogSync | 标记所有的更改已执行 |
| changelogSyncSQL | 生成标记更改已执行的sql并输出到标准输出 |
| markNextChangeSetRan | 将下一个变更标记为已执行 |
| markNextChangeSetRanSQL | 生成将下一个变更标记为已执行的sql并输出到标准输出 |
| listLocks | 列出liquibase数据库锁 |
| releaseLocks | 释放所有的liquibase数据库锁 |
| dropAll | 删除数据库表(慎用！) |
