​Liquibase的简单使用 ​

目录

将项目需要的表结构或数据(数据字段类型数据),通过日志自动同步到数据库。

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


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

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

之所以选择使用liquibase,原因其实挺尴尬的,由于我不会使用容器化技术,不会写dockfile运行项目初始化sql脚本,就想有没有什么简单方便的形式,最后看中了liquibase,配置起来确实简单方便。

我是用命令行的形式生成changeLog,然后再集成到springboot中。官网上提供的还有基于ant、maven和服务端的使用的方式,以后再研究。

1.     下载liquibase的安装包,解压到指定目录下;


2. 通过​​generateChangeLog​​生成现有数据库的changeLog文件;

3.  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>

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


到此已经位置好了,启动一下项目,控制台打印出liquibase初始化信息,这时候查看数据库,会表现数据库已经初始完毕,后面数据库如果有变动,可以再生成新的changelog文件,再次添加到项目中,达到持续集成的效果。整个项目的源代码已经托管到github上了,可以​​点击查看​​。