说明:

(1)Spring Boot 版本:1.5.12.RELEASE

(2)Liquibase版本:3.5.5

 

前言:

在前面几节介绍了Flyway,这节就介绍下Liquibase。

 

一、什么是Liquibase?

官网地址:http://www.liquibase.org

LiquiBase是一个用于数据库重构和迁移的开源工具,通过日志文件的形式记录数据库的变更,然后执行日志文件中的修改,将数据库更新或回滚到一致的状态。

 

二、Liquibase的特点?

Liquibase的主要特点有:

(1)支持几乎所有主流的数据库,如MySQL, PostgreSQL, Oracle, Sql Server, DB2等;
(2)支持多开发者的协作维护;
(3)日志文件支持多种格式,如XML, YAML, JSON, SQL等;

(4)支持多种运行方式,如命令行、Spring集成、Maven插件、Gradle插件等;

 

 

三、Liquibase在Sping Boot的使用

 

3.1 新建一个项目

       新建项目,取名为:springboot-liquibase

3.2 添加依赖

       在pom.xml文件中添加依赖:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.kfit</groupId>
    <artifactId>springboot-liquibase</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>
    <name>springboot-liquibase</name>
    <description>Demo project for Spring Boot</description>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.5.12.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.liquibase</groupId>
            <artifactId>liquibase-core</artifactId>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

 

说明:

(1)Liquibase的依赖是:liquibase-core;

(2)为什么需要配置JPA和MySQL驱动:默认情况下,Liquibase会自动注入注解了@Primary的DataSource,那么这个数据源是哪来的呢?那这里就是使用了JPA了(当然你可以使用jdbcTemplate或者是MyBatis);由于我们使用mysql数据库进行测试,那么就需要引入MySQL驱动了。

 

3.3 添加配置

       在application.properties文件添加配置:

### datasource
spring.datasource.platform=mysql
spring.datasource.url = jdbc:mysql://localhost:3306/liquibase_test
spring.datasource.username = root
spring.datasource.password = root
spring.datasource.driverClassName = com.mysql.jdbc.Driver
### jpa
spring.jpa.database = MYSQL
spring.jpa.show-sql = true
spring.jpa.hibernate.ddl-auto = none

 

       这个没什么好说的,就是数据源和jpa的基本配置。

3.4 Flyway存放路径说明

       默认情况下是db/changelog,但你能够使用liquibase.change-log进行修改。这里我们由于在接下里的测试中使用的是SQL的方式,所以需要修改下。为了接下里的测试,在resources创建目录db/changelog:

src/main/resources

       - db

              -- changelog

       其次在application.properties中添加配置:

### liquibase

liquibase.change-log=classpath:/db/changelog/db.changelog-master.sql

 

3.5 Liquibase sql脚本命令规则

       对于Liquibase的脚本db.changelog-master.sql(这里也是.xml或者是.yaml)如果使用的xml的话,那么在上面的配置中需要做下调整。

 

3.6 测试一

       db/changelog下新建文件db.changelog-master.sql,脚本如下:

--liquibase formatted sql
--changeset andy:1.1
CREATE TABLE book (
  id  int UNSIGNED NOT NULL AUTO_INCREMENT,
  name  varchar(255) NULL,
  createTime  datetime NULL ON UPDATE CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`)
);

 

说明:

(1)--liquibase formatted sql:代表使用格式化的sql;

(2)--changeset andy:1.1:andy代表作者,1.1代表id,也就是版本号,这里没有大小之后,Liquibase是按照顺序执行的。

运行应用,查看数据库中是否多了三个表:

其一是book表,这是我们脚本中创建的,其二是Liquibase版本管理的表DATABASECHANGELOG和DATABASECHANGELOGLOCK。其中DATABASECHANGELOG是每个版本的日志表,DATABASECHANGELOGLOCK是日志锁表。

 

3.7 测试二

       在db.changelog-master.sql下追加脚本(Liquibase的升级版本配置是在同一个文件里的),如下:

--changeset andy:1.2
INSERT INTO book(name, createTime) VALUES ('从零开始学Spring Boot', '2018-04-21 16:53:48');

 

       当前整个文件看起来是这样子的:

--liquibase formatted sql
--changeset andy:1.1
CREATE TABLE book (
  id  int UNSIGNED NOT NULL AUTO_INCREMENT,
  name  varchar(255) NULL,
  createTime  datetime NULL ON UPDATE CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`)
);
--changeset andy:1.2
INSERT INTO book(name, createTime) VALUES ('从零开始学Spring Boot', '2018-04-21 16:53:48');

 

运行应用,查看book表中是否多了条数据,DATABASECHANGELOG是否多了条版本记录。

 

       到此为止,Liquibase的使用就一切顺利了,到这里就告一段落了。

 

 

「SpringCloud视频」最近更新:

 

24. 覆写Feign的默认配置Configuration之Contract
25. Spring Cloud中关于Feign的常见问题总结
26. 解决Spring Cloud中FeignRibbon第一次请求失败的方法
27. Feign添加 fallbackFactory 属性来触发请求进行容灾降级
28. 断路器Hystrix总结
29. Health Indicator(健康指标) 和metrics stream(指标流)
30. 断路器监控(Hystrix Dashboard)
31. 断路器聚合监控(turbine)



 搜索「springboot」或者扫描以下二维码即可关注:

196. Spring Boot 数据库迁移:Liquibase_spring