SpringBoot整合liquibase及liquibase生成初始化脚本的方式

一. SpringBoot集成liquibase

项目集成liquibase作用

1. 对数据库表字段进行版本控制

2. 项目初始化部署时初始化数据库表和数据

①.导入pom依赖

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

②.配置application.yml文件,指定master.xml

spring:
 liquibase:
   change-log: classpath:liquibase/master.xml #指定master.xml文件的位置

不同spring版本配置方式不一样
具体看源码LiquibaseProperties中配置

③.新建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.4.xsd">
   <include file="classpath:liquibase/change_log/init_table.xml" relativeToChangelogFile="false"/>
   <include file="classpath:liquibase/change_log/init_data.xml" relativeToChangelogFile="false"/>
</databaseChangeLog>

④.将数据库表初始脚本init_table.xml和数据初始脚本init_data.xml放到项目目录下

脚本可以通过手写的方式或者通过liquibase自动生成;

启动项目如果第一次运行则会在数据库中创建表和数据
后面如果脚本中有新增表或者字段启动项目的时候也会自动创建生成

二. liquibase生成数据库表和数据的初始化脚本

liquibase有两种方式生成初始化脚本

方法一:在官网下载liquibase压缩包,使用原生的命令行指令来生成

下载liquibase压缩包,解压,将mysql连接jar包复制一份到此目录下

进入解压目录执行如下执行

根据数据库生成表结构文件

./liquibase --driver=com.mysql.cj.jdbc.Driver --classpath=mysql-connector-java-8.0.17.jar --changeLogFile=./init-data.xml --url="jdbc:mysql://192.168.0.162:3306/hello_world" --username=root --password=123456 --diffTypes=data generateChangeLog

根据数据库生成初始数据文件

./liquibase --driver=com.mysql.cj.jdbc.Driver --classpath=mysql-connector-java-8.0.17.jar --changeLogFile=./init-table.xml --url="jdbc:mysql://192.168.0.162:3306/hello_world" --username=root --password=123456 generateChangeLog

• 数据库驱动取决于数据库

&ndash;driver=com.mysql.cj.jdbc.Driver

• mysql连接

&ndash;classpath=mysql-connector-java-8.0.17.jar

• 自定义生成的初始化脚本文件名

&ndash;changeLogFile=./init-data.xml

• 数据库连接地址

&ndash;url=&ldquo;jdbc:mysql://192.168.0.162:3306/hello_world&rdquo;

• 数据库用户名密码

-username=root
&ndash;password=123456

• 生成初始化表数据需要加上这个配置,生成表结构则不加

-diffTypes=data

方法二:使用Maven插件

<plugin>
<groupId>org.liquibase</groupId>
<artifactId>liquibase-maven-plugin</artifactId>
<version>3.4.2</version>
<configuration>
<changeLogFile>${basedir}/src/main/resources/liquibase/change_log/changelog.xml</changeLogFile>
<!--changelog文件生成位置-->
<outputChangeLogFile>${basedir}/src/main/resources/liquibase/change_log/changelog.xml</outputChangeLogFile>
<!--数据库连接-->
<driver>com.mysql.jdbc.Driver</driver>
<url>jdbc:mysql://192.168.0.30:3306/school</url>
<username>qj</username>
<password>123456</password>
<!--输出文件编码-->
<outputFileEncoding>UTF-8</outputFileEncoding>
<!--执行的时候是否显示详细的参数信息-->
<verbose>true</verbose>
<!--连接非本地数据库是否弹出提示框-->
<promptOnNonLocalDatabase>false</promptOnNonLocalDatabase>
<!--生成changelog文件内容-->
<diffTypes>tables, views, columns, indexs,foreignkeys, primarykeys, uniqueconstraints, data</diffTypes>
</configuration>
</plugin>

如果只是生成数据库表脚本,则将上面的diffTypes注释起来或者去掉里面的data
如果只是生成数据脚本,则只留下data
如果要把数据表脚本和数据脚本生成到一个文件则保留上面的difftypes所有内容

安装好maven插件后maven插件中可以看如下图的指令,点击即可生成脚本文件

生成脚本如下

<?xml version="1.0" 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.4.xsd">

<changeSet author="404997819 (generated)" id="1590732067909-4">
       <createTable tableName="t_student">
           <column autoIncrement="true" name="studentId" remarks="学生自增ID" type="INT">
               <constraints primaryKey="true"/>
           </column>
           <column name="classId" remarks="班级ID" type="INT"/>
           <column name="userCode" remarks="用户唯一码" type="VARCHAR(20)"/>
           <column name="studentName" remarks="学生姓名" type="VARCHAR(20)"/>
           <column name="studentImageUrl" remarks="学生头像地址" type="VARCHAR(200)"/>
           <column name="studentCode" remarks="学生学号" type="VARCHAR(50)"/>
           <column name="IDCard" remarks="身份证号" type="VARCHAR(50)"/>
           <column name="status" remarks="学生状态 1:在读 0：毕业 -1:转校" type="VARCHAR(5)"/>
           <column name="flag" remarks="是否删除 1:正常显示，-1:表示删除" type="VARCHAR(10)"/>
           <column name="createDate" remarks="创建时间" type="datetime"/>
       </createTable>
   </changeSet>

<changeSet author="404997819 (generated)" id="1590732067909-6">
       <createTable tableName="t_teacherRelation">
           <column autoIncrement="true" name="teacherRelationId" remarks="主键自增ID" type="INT">
               <constraints primaryKey="true"/>
           </column>
           <column name="classId" remarks="班级ID" type="INT"/>
           <column name="teacherId" remarks="教师ID" type="INT"/>
           <column name="teacherType" remarks="教师类型 1:班主任" type="VARCHAR(10)"/>
           <column name="flag" remarks="是否删除 1:正常显示，-1:表示删除" type="VARCHAR(10)"/>
           <column name="createDate" remarks="创建时间" type="datetime"/>
       </createTable>
   </changeSet>

<changeSet author="404997819 (generated)" id="1590732067909-10">
       <createIndex indexName="Reft_userinfo88" tableName="t_api_logs">
           <column name="apiToken"/>
       </createIndex>
   </changeSet>
</databaseChangeLog>

参考文章如下
http://blog.jiunile.com/％E6％95％B0％E6％8D％AE％E5％BA％93％E7％89％88％E6％9C％AC％E7％AE％A1％E7％90％86％E5％B7％A5％E5％85％B7liquibase.html
https://blog.csdn.net/cover1231988/article/details/78124673?utm_source=blogxgwz5
https://www.cnblogs.com/tonyq/p/8039770.html
https://www.jianshu.com/p/07a45b6722fd

来源：https://blog.csdn.net/lutianchuang/article/details/106414796