马克社区,马克吐温社区,马克java社区196. Spring Boot 数据库迁移：Liquibase 框架

196. Spring Boot 数据库迁移：Liquibase

说明：

（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/> 
        </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的使用就一切顺利了，到这里就告一段落了。

购买完整视频，请前往：http://www.mark-to-win.com/TeacherV2.html?id=287