Liquibase 在 Spring Boot 中的使用詳細介紹

Liquibase 是一個強大的數據庫版本控制工具,能夠幫助開發(fā)者管理和追蹤數據庫結構和數據的變更。通過與 Spring Boot的集成,Liquibase 提供了便捷的數據庫遷移和版本控制功能。本文將通過多個豐富的示例,詳細講解如何在 Spring Boot項目中使用 Liquibase。
1. 項目準備
1.1 創(chuàng)建 Spring Boot 項目
訪問 Spring Initializr 創(chuàng)建新的 Spring Boot 項目,選擇以下依賴項:
- Spring Web
- Spring Data JPA
- MySQL Driver(或其他數據庫驅動)
- Liquibase Migration
下載并解壓縮生成的項目。
1.2 添加 Maven 依賴
在 pom.xml 中,確保添加 Liquibase 的依賴:
<dependency>
<groupId>org.liquibase</groupId>
<artifactId>liquibase-core</artifactId>
<version>4.x.x</version> <!-- 使用最新版本 -->
</dependency>同時確保包含 Spring Data JPA 和數據庫驅動的依賴,例如 MySQL:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
</dependency>1.3 配置數據庫連接
在 src/main/resources/application.properties 中配置數據庫連接信息:
spring.datasource.url=jdbc:mysql://localhost:3306/my_database?useSSL=false&serverTimezone=UTC spring.datasource.username=my_user spring.datasource.password=my_password spring.jpa.hibernate.ddl-auto=none spring.liquibase.change-log=classpath:db/changelog/db.changelog-master.xml
2. 示例 1:創(chuàng)建用戶表
2.1 創(chuàng)建變更日志文件
在 src/main/resources/db/changelog 目錄下創(chuàng)建一個變更日志文件 db.changelog-master.xml,并定義用戶表的創(chuàng)建。
<?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-4.3.xsd">
<changeSet id="1" author="authorName">
<createTable tableName="users">
<column name="id" type="int">
<constraints primaryKey="true" autoIncrement="true"/>
</column>
<column name="name" type="varchar(100)">
<constraints nullable="false"/>
</column>
<column name="email" type="varchar(100)">
<constraints unique="true"/>
</column>
<column name="created_at" type="timestamp">
<constraints nullable="false" defaultValueComputed="CURRENT_TIMESTAMP"/>
</column>
</createTable>
</changeSet>
</databaseChangeLog>2.2 啟動應用程序
運行應用程序:
mvn spring-boot:run
2.3 驗證結果
使用數據庫管理工具檢查 my_database,確認 users 表已成功創(chuàng)建。
SHOW TABLES; -- 查看數據庫中的所有表 SELECT * FROM users; -- 查看 users 表
3. 示例 2:添加列和修改列類型
3.1 修改變更日志文件
在 db.changelog-master.xml 中添加新的變更集,用于向 users 表添加 age 列并修改 name 列的類型。
<changeSet id="2" author="authorName">
<addColumn tableName="users">
<column name="age" type="int"/>
</addColumn>
</changeSet>
<changeSet id="3" author="authorName">
<modifyDataType tableName="users" columnName="name" newDataType="varchar(255)"/>
</changeSet>3.2 再次啟動應用程序
重新啟動應用程序,Liquibase 會檢測到新的變更集并應用。
mvn spring-boot:run
3.3 驗證結果
使用數據庫管理工具,檢查 users 表,確認 age 列已經添加,并且 name 列的類型已更新。
DESCRIBE users; -- 查看 users 表的結構
4. 示例 3:創(chuàng)建訂單表并添加外鍵約束
4.1 修改變更日志文件
在 db.changelog-master.xml 中添加新的變更集,用于創(chuàng)建 orders 表并添加外鍵約束。
<changeSet id="4" author="authorName">
<createTable tableName="orders">
<column name="id" type="int">
<constraints primaryKey="true" autoIncrement="true"/>
</column>
<column name="user_id" type="int"/>
<column name="product" type="varchar(100)">
<constraints nullable="false"/>
</column>
<column name="quantity" type="int">
<constraints nullable="false"/>
</column>
<column name="order_date" type="timestamp">
<constraints defaultValueComputed="CURRENT_TIMESTAMP"/>
</column>
<foreignKeyConstraint baseTableName="orders" baseColumnNames="user_id"
referencedTableName="users" referencedColumnNames="id"
constraintName="fk_user_id"/>
</createTable>
</changeSet>4.2 啟動應用程序
再次運行應用程序:
mvn spring-boot:run
4.3 驗證結果
使用數據庫管理工具檢查 my_database,確認 orders 表已成功創(chuàng)建,并且 user_id 列與 users 表的 id 列建立了外鍵關系。
SHOW TABLES; -- 查看數據庫中的所有表 SELECT * FROM orders; -- 查看 orders 表
5. 示例 4:數據填充
5.1 創(chuàng)建數據填充變更集
在 db.changelog-master.xml 中添加一個新的變更集,用于插入初始數據。
<changeSet id="5" author="authorName">
<insert tableName="users">
<column name="name" value="John Doe"/>
<column name="email" value="john@example.com"/>
<column name="age" value="30"/>
</insert>
<insert tableName="users">
<column name="name" value="Jane Smith"/>
<column name="email" value="jane@example.com"/>
<column name="age" value="25"/>
</insert>
</changeSet>5.2 啟動應用程序
再次啟動應用程序,Liquibase 會自動將數據插入 users 表。
mvn spring-boot:run
5.3 驗證結果
檢查 users 表,確認數據已正確插入。
SELECT * FROM users; -- 查看 users 表中的數據
6. 示例 5:回滾變更
6.1 添加回滾操作
在 db.changelog-master.xml 中,您可以為變更集添加回滾操作。例如,為創(chuàng)建 users 表的變更集添加回滾邏輯:
<changeSet id="1" author="authorName">
<createTable tableName="users">
<column name="id" type="int">
<constraints primaryKey="true" autoIncrement="true"/>
</column>
<column name="name" type="varchar(100)">
<constraints nullable="false"/>
</column>
<column name="email" type="varchar(100)">
<constraints unique="true"/>
</column>
<column name="created_at" type="timestamp">
<constraints nullable="false" defaultValueComputed="CURRENT_TIMESTAMP"/>
</column>
</createTable>
<rollback>
<dropTable tableName="users"/>
</rollback>
</changeSet>6.2 執(zhí)行回滾
如果需要回滾到之前的狀態(tài),可以使用以下命令:
mvn liquibase:rollback -Dliquibase.rollbackCount=1
6.3 驗證回滾結果
運行回滾命令后,使用數據庫管理工具確認 users 表已被刪除。
SHOW TABLES; -- 查看數據庫中的所有表
7. 示例 6:使用 YAML 配置文件
除了 XML,Liquibase 還支持使用 YAML 格式的變更日志。以下是一個使用 YAML 的示例。
7.1 創(chuàng)建 YAML 變更日志文件
在 src/main/resources/db/changelog 目錄下創(chuàng)建一個名為 db.changelog-master.yaml 的文件:
databaseChangeLog:
- changeSet:
id: 1
author: authorName
changes:
- createTable:
tableName: users
columns:
- column:
name: id
type: int
constraints:
primaryKey: true
autoIncrement: true
- column:
name: name
type: varchar(100)
constraints:
nullable: false
- column:
name: email
type: varchar(100)
constraints:
unique: true
- column:
name: created_at
type: timestamp
constraints:
nullable: false
defaultValueComputed: CURRENT_TIMESTAMP7.2 更新配置
在 application.properties 中更新 spring.liquibase.change-log 的路徑:
spring.liquibase.change-log=classpath:db/changelog/db.changelog-master.yaml
7.3 啟動應用程序
再次啟動應用程序,Liquibase 會根據 YAML 配置創(chuàng)建 users 表。
mvn spring-boot:run
8. 總結
通過以上豐富的示例,我們展示了如何在 Spring Boot 項目中使用 Liquibase 進行數據庫版本控制和變更管理。Liquibase 提供了靈活的變更集機制,支持創(chuàng)建表、修改列、填充數據、回滾變更等多種操作。無論是使用 XML 還是 YAML 格式,Liquibase 都能夠幫助開發(fā)者有效管理數據庫的演變,使得開發(fā)過程更加高效和可靠。
到此這篇關于Liquibase 在 Spring Boot 中的使用--詳細介紹的文章就介紹到這了,更多相關 Spring Boot Liquibase使用內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家!
相關文章
JFinal使用ajaxfileupload實現圖片上傳及預覽
這篇文章主要為大家詳細介紹了JFinal使用ajaxfileupload實現圖片上傳及預覽,文中示例代碼介紹的非常詳細,具有一定的參考價值,感興趣的小伙伴們可以參考一下2019-09-09
解決mybatis使用foreach批量insert異常的問題
這篇文章主要介紹了解決mybatis使用foreach批量insert異常的問題,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧2021-01-01

