LiquiBase数据库版本管理组件使用

简介

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

LiquiBase的主要特点有：

支持几乎所有主流的数据库，如MySQL, PostgreSQL, Oracle, Sql Server, DB2等；

支持多开发者的协作维护；

日志文件支持多种格式，如XML, YAML, JSON, SQL等；

支持多种运行方式，如命令行、Spring集成、Maven插件、Gradle插件等；

changelog文件格式

changelog是LiquiBase用来记录数据库的变更，一般放在CLASSPATH下，然后配置到执行路径中。

changelog支持多种格式，主要有XML/JSON/YAML/SQL，其中XML/JSON/YAML除了具体格式语法不同，节点配置很类似，SQL格式中主要记录SQL语句，后面实例有给出XML格式和SQL格式的示例，更多的格式示例请参考http://www.liquibase.org/

常用的标签及命令

1. 标签

一个<changeSet>标签对应一个变更集，由属性id、name，以及changelog的文件路径唯一标识。changelog在执行的时候并不是按照id的顺序，而是按照changeSet在changelog中出现的顺序。

changelog中的一个changeSet对应一个事务，在changeSet执行完后commit，如果出现错误则rollback。

2. <include>与<includeAll>标签

<include>的file属性表示要包含的changelog文件的路径，这个文件可以是LiquiBase支持的任意格式，relativeToChangelogFile如果为true，则表示file属性表示的文件路径是相对于根changelog而不是CLASSPATH的，默认为false。

<includeAll>指定的是changelog的目录，而不是为文件，如：

注意: 目前<include>没有解决重复引用和循环引用的问题，重复引用还好，LiquiBase在执行的时候可以判断重复，而循环引用会导致无限循环，需要注意！

实例

pom.xml

<dependency>

       <groupId>org.liquibase</groupId>

       <artifactId>liquibase-core</artifactId>

</dependency>

LiquiBase数据库版本管理组件使用

@Configuration

public class LiquibaseConfig {

    private @Autowired DataSource dataSource;

    private @Autowired Environment environment;

    @Bean(name = "liquibase")

    public SpringLiquibase liquibase(){

        SpringLiquibase lb = new SpringLiquibase();

        lb.setDataSource(dataSource);

        lb.setChangeLog("classpath:liquibase/changelog-master.xml");    lb.setContexts(environment.getProperty(StandardEnvironment.ACTIVE_PROFILES_PROPERTY_NAME));

        return lb;

    }

}

changelog-master.xml

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

        xmlns:ext="http://www.liquibase.org/xml/ns/dbchangelog-ext"

        xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-3.1.xsd

        http://www.liquibase.org/xml/ns/dbchangelog-ext http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-ext.xsd">



    <includeAll path="liquibase/changelogs"/>

</databaseChangeLog>

changelog-1.0.0.xml

LiquiBase数据库版本管理组件使用

changelog-1.1.0.sql

-- liquibase formatted sql

-- 部门

-- changeset lenky.li:department-createTable-20181205

CREATE TABLE `department` (

        `id` int(11) NOT NULL AUTO_INCREMENT,

        `name` varchar(60) DEFAULT NULL COMMENT '部门名称',

        `create_time` timestamp NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',

        `update_time` timestamp NULL DEFAULT CURRENT_TIMESTAMP COMMENT '更新时间',

        PRIMARY KEY (`id`)

) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='部门';