196. Spring Boot 数据库迁移：Liquibase

 

【视频&交流平台】

à SpringBoot视频：http://t.cn/R3QepWG

à SpringCloud视频：http://t.cn/R3QeRZc

à Spring Boot源码：https://gitee.com/happyangellxq520/spring-boot

à Spring Boot交流平台：http://412887952-qq-com.iteye.com/blog/2321532

à Spring Boot Shiro视频：http://t.cn/R3QDMbh

à Spring Boot 2.0 之Spring Data 和JPA：http://t.cn/R1pSojf

 

 历史相关章节：

193. Spring Boot 数据库迁移：概述

194. Spring Boot 数据库迁移：Flyway

 

195. Spring Boot 2.0数据库迁移：Flyway

 

说明：

（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)

 SpringCloud视频：http://t.cn/R3QeRZc

 

 

微信公众号「SpringBoot」最近更新：

 

Java8新特性：接口的默认方法
208. Spring Boot Swagger2：排序 – 漂游记
207. Spring Boot Swagger2：极简方式
我读的书很多，但都没有你好看【一禅录】
206. Spring Boot 2.0 Swagger2：使用
205. Spring Boot 2.0 Swagger2：初识Swagger
当要离开的时候，我却动情了
205. jetcache：你需要知道的小技巧
204. jetcache：在Spring Boot中怎么玩？
遇见阿里，遇见自己
203. 阿里jetcache
202. 阿里Pandora Boot
微信公众号赞赏功能升级了，真的假的？
《喜剧之王》「我养你啊」之人生选择
201. Spring Boot JNDI：Spring Boot中怎么玩JNDI
510阿里日，马老师献上最走心、最科技范儿证婚词～
200. Spring Boot JNDI：在Tomcat中怎么玩JNDI?
199. Spring Boot JNDI：这是虾米？
Spring Boot 数据库迁移系列
Spring Boot葵花宝典：初露锋芒：MyBatis insert异常 Parameter 'name' not found
198. Spring Boot Flyway工作原理

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