01 引言

Liquibase是一个数据库变更的版本控制工具。

项目中通过Liquibase解析用户编写的Liquibase的配置文件，生成sql语句，并执行和记录（执行是根据记录确定sql语句是否曾经执行过，和配置文件里的预判断语句确定sql是否执行）。

02 SpringBoot 集成Liquibase

step1：添加依赖

首先需要在项目引入Liquibase依赖：

<dependency>
    <groupId>org.liquibase</groupId>
    <artifactId>liquibase-core</artifactId>
    <version>3.6.3</version>
</dependency>

step2：添加配置文件

/**
 * Liquibase配置类
 *
 * @author : YangLinWei
 * @createTime: 2022/4/28 4:48 下午
 * @version: 1.0.0
 */
@Slf4j
@Configuration
public class LiquibaseConfig {

    /*** 指定liquibase的版本 **/
    @Value("${dc.version:main}")
    private String contexts;

	/*** 是否开启liquibase **/
    @Value("${dc.liquibase.enable:true}")
    private Boolean enable;

    /*** liquibase用到的两张表 **/
    private static final String DATABASE_CHANGE_LOG_TABLE = "lqb_changelog_demo";
    private static final String DATABASE_CHANGE_LOG_LOCK_TABLE = "lqb_lock_demo";

    @Resource
    private DataSource dataSource;

    /**
     * liquibase bean声明
     */
    @Bean
    public SpringLiquibase liquibase() {
        SpringLiquibase liquibase = new SpringLiquibase();
        // Liquibase文件路径
        liquibase.setChangeLog("classpath:sql/master.xml");
        liquibase.setDataSource(dataSource);
        if (StringUtils.isNotBlank(contexts)) {
            liquibase.setContexts(contexts);
        }
        liquibase.setShouldRun(enable);
        liquibase.setResourceLoader(new DefaultResourceLoader());
        // 覆盖Liquibase changelog表名
        liquibase.setDatabaseChangeLogTable(DATABASE_CHANGE_LOG_TABLE);
        liquibase.setDatabaseChangeLogLockTable(DATABASE_CHANGE_LOG_LOCK_TABLE);
        return liquibase;
    }
}

从里面的代码，可以看到还需要在sources目录下新建sql文件夹，然后添加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">

    <changeSet id="v1.0.0-1" author="ylw" context="main">
        <sqlFile path="classpath:/sql/v1.0.0/1.init.sql"/>
        <sqlFile path="classpath:/sql/v1.0.0/2.init-data.sql"/>
        <sqlFile path="classpath:/sql/v1.0.0/3.init-data-1.sql"/>
    </changeSet>

</databaseChangeLog>

从配置文件里可以看到，定义了一个changeSet，里面有很多个sql脚本文件，分别是：

1.init.sql：一般写的都是ddl脚本（注意：CREATE TABLE需要判断IF NOT EXISTS）；
2.init-data.sql：一般写的都是dml脚本（注意：这个文件的sql不能带有转义字符，Liquibase的一个bug）
3.init-data-1.sql：把 2.init-data.sql文件带有转义的sql写入这里面。

文件结构如下：在这里插入图片描述

step3：启动项目

启动项目的时候，会读取 “LiquibaseConfig” 的配置文件，然后就会在数据库里新建Liquibase相关的两张表（LiquibaseConfig里面定义的），这这两张表记录的是Liquibase的数据库脚本的升级过程，下次启动是就会先读这张表的数据，在必读master.xml文件来做脚本升级。

内容大致为：

lqb_changelog_demo：