SpringBoot整合liquibase及liquibase生成初始化腳本

Posted on by

一. 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
  • 數據庫驅動取決於數據庫

–driver=com.mysql.cj.jdbc.Driver

  • mysql連接

–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

方法二:使用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

到此這篇關於SpringBoot整合liquibase的文章就介紹到這瞭,更多相關SpringBoot整合liquibase內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet！

推薦閱讀：