Liquibase的简单使用[通俗易懂]

全栈程序员站长

发布于 2022-09-20 18:42:44

5.3K0

大家好，又见面了，我是你们的朋友全栈君。

LiquiBase是一个用于数据库重构和迁移的开源工具，通过日志文件的形式记录数据库的变更，然后执行日志文件中的修改，将数据库更新或回滚到一致的状态。它的目标是提供一种数据库类型无关的解决方案，通过执行schema类型的文件来达到迁移。其有点主要有以下：

支持几乎所有主流的数据库，如MySQL, PostgreSQL, Oracle, Sql Server, DB2等；
支持多开发者的协作维护；
日志文件支持多种格式，如XML, YAML, JSON, SQL等；
支持多种运行方式，如命令行、Spring集成、Maven插件、Gradle插件等。

更多详情介绍，可以浏览官网doc。

之所以选择使用liquibase，原因其实挺尴尬的，由于我不会使用容器化技术，不会写dockfile来运行项目初始化sql脚本，就想有没有什么简单方便的形式，最后看中了liquibase，配置起来确实简单方便。我是用命令行的形式生成changeLog，然后再集成到springboot中。官网上提供的还有基于ant、maven和服务端的使用的方式，以后再研究。

下载liquibase的安装包，解压到指定目录下；

通过generateChangeLog生成现有数据库的changeLog文件；

 liquibase --driver=com.mysql.jdbc.Driver --classpath=mysql-connector-java-5.1.27.jar --changeLogFile=./dbchangelog.xml --url="jdbc:mysql://localhost:3306/blog" --username=root --password=root generateChangeLog

generateChangeLog命令默认只会创建数据库结构的变更日志文件，如果希望创建插入数据的变更日志文件，可以使用参数diffTypes，该参数包括如下可选项：

tables [DEFAULT]表

columns [DEFAULT] 列

views [DEFAULT] 视图

primaryKeys [DEFAULT] 主键

indexes [DEFAULT] 索引

foreignKeys [DEFAULT]

sequences [DEFAULT]

data 例如生成数据：

  liquibase --driver=com.mysql.jdbc.Driver --classpath=mysql-connector-java-5.1.27.jar --changeLogFile=./dbchangelog.xml --url="jdbc:mysql://localhost:3306/blog" --username=root --password=root --diffTypes=data generateChangeLog

我分别生成了两个changeLog文件，一个是inti-table.xml; 一个是init-data.xml。 3.项目中配置liquibase 首先在项目中添加支持：

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

通过查看源码，我们能看到默认的配置文件存放的位置：

这里我没有使用默认的配置，指定了一个自己的路径，只需要在application.properties中添加如下配置：

#liquibase
liquibase.change-log=classpath:/liquibase/master.xml

--master.xml文件内容，通过inclue标签引入了两个changelog，就是之前的表结构和表数据。

<?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>

项目中的目录结构如下图所示：