liquibase学习和使用

liquibase学习

介绍

Liquibase 是一种数据库结构更改管理解决方案，能够从开发到生产更快、更安全地修订和发布数据库更改。

数据库更新日志和数据库更新日志锁定

部署更改时，Liquibase 会在数据库中创建两个表：DATABASECHANGELOG 和 DATABASECHANGELOGLOCK。
数据库更改日志表跟踪已部署的更改，以便您有记录。Liquibase 将变更日志文件中的变更集与 DATABASECHANGELOG 跟踪表进行比较，并仅部署新的变更集。

DATABASECHANGELOGLOCK 可防止 Liquibase 的多个实例同时更新数据库。该表在部署期间管理对 DATABASECHANGELOG 表的访问，并确保只有一个 Liquibase 实例正在更新数据库。

相关概念

changelog

Liquibase 使用changelog按顺序列出对数据库所做的所有更改。
changelog单个更改单元称为changeset，changeset是 Liquibase 中变化的基本单位。将所有changeset存储在changelog中
不同的文件格式(sql,yaml,xml,json)对changeset的描述是不一样的，只是sql文件格式学习成本最低
changset是由changelog的文件路径和author属性和id属性唯一确认的

changeset的属性

precondition

precondition是添加到changelog或单个changeset的标记，用于根据数据库的状态控制更新的执行。通过precondition，您可以指定changeset的安全性和标准化要求。如果changeset上的precondition失败，Liquibase 不会部署该changeset。不过也可以设置不同的属性控制错误的处理方式。
该属性可以在changeset执行前进行检查。
sql文件格式的changelog只支持sqlCheck，其他文件格式支持的检查会多一些。

sql样例

--liquibase formatted sql
			
--changeset Liquibase User:1
--precondition-sql-check expectedResult:0 SELECT COUNT(*) FROM primary_table
--comment: /*comments should go after preCondition. If they are located before the precondition, then Liquibase usually gives error.*/
create table primary_table (  
	id int primary key,
	name varchar(50) not null,
	address1 varchar(50),
	address2 varchar(50),
	city varchar(30)
)

Contexts

使用该属性可以在进行更新数据库时，根据输入的参数对changeset进行过滤；属性值是不区分大小写的字符串。具体的判断逻辑可以参考该链接

sql样例

--changeset bob:1 contextFilter:test
insert into news (id, title) values (1, 'Liquibase 0.8 Released')

Label

使用该属性可以在进行更新数据库时，根据输入的参数对changeset进行过滤；属性值是不区分大小写的字符串。label和contexts的具体的判断逻辑可以参考该链接

sql样例

--liquibase formatted sql

--changeset Liquibase User:1 labels:1.0
create table primary_table (  
   id int primary key,
   name varchar(50) not null,
   address1 varchar(50),
   address2 varchar(50),
   city varchar(30)
)

文件格式

sql样例

/*
 changelog标准开头
 */
--liquibase formatted sql

/*
  changeset标准开头 author:id
 */
--changeset nvoxland:1
/* 设置前置条件属性 */
--preconditions onFail:HALT onError:HALT
/* 设置前置条件sql check，sql格式支支持sqlcheck */
--precondition-sql-check expectedResult:0 SELECT COUNT(*) FROM my_table
create table test1 (
                       id int primary key,
                       name varchar(255)
);
/*
  rollback标准开头
 */
--rollback drop table test1;

--changeset nvoxland:2
insert into test1 (id, name) values (1, ‘name 1′);
insert into test1 (id,  name) values (2, ‘name 2′);


--changeset nvoxland:3 dbms:oracle
create sequence seq_test;

其他格式用的时候在补充

跟踪表

DATABASECHANGELOGLOCK （数据库更改日志锁定表）

Liquibase 使用 DATABASECHANGELOGLOCK 表来确保一次只运行一个 Liquibase 实例。
当您进行数据库更新时，Liquibase 会从 DATABASECHANGELOG 表中读取数据，以确定需要运行哪些变更集。为了避免并发更新之间的冲突（如果多个开发人员使用相同的数据库实例，或者集群中的多个服务器在启动时自动运行 Liquibase，则可能会发生冲突），当更新当前正在运行时，DATABASECHANGELOGLOCK 表将该列设置为 1。如果您在此期间进行其他更新，Liquibase 会等到锁释放后再运行它。

DATABASECHANGELOG （数据库更新日志表）

Liquibase 使用 DATABASECHANGELOG 表来跟踪运行了哪些变更集。如果数据库中不存在该表，Liquibase 会自动创建一个表。

命令

Liquibase 附带的几个命令，可以帮助迁移和更改数据库。
主要包含start命令、update命令、rollback命令、inspection 命令、tracking 命令、Maintenance 命令、checks 命令、Hub 命令。
Liquibase命令详细

update

该命令将部署changelog文件中尚未部署到数据库的任何更改。
运行该命令时，Liquibase 会按顺序读取changelog文件中的changset，然后将author 和 id的唯一标识符与存储在 DATABASECHANGELOG 表中的值进行比较。

执行情况

1. 如果唯一标识符不存在，Liquibase 会将changset应用于数据库。

2. 如果存在唯一标识符，则将changset的 MD5Sum 与数据库中的 MD<>Sum 进行比较。如果它们不同，Liquibase 将生成一条错误消息，声明有人意外更改了changeset。但是，如果将changeset的属性runOnChange or runAlways 设置为True ，Liquibase 将重新应用changeset。

liquibase使用

基于SpringBoot maven集成Liquibase

1. 打开pom.xml,添加liquibase依赖

<dependency>
   <groupId>org.liquibase</groupId> 
   <artifactId>liquibase-core</artifactId>
</dependency>

2. 打开spring配置文件application.properties，添加以下配置

spring:
  datasource:
    url: jdbc:postgresql://localhost:5432/yourdatabase
    username: root
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver
  liquibase:
    #是否启用liquibase
    enabled: true
    change-log: classpath:db/changelog/changelog.yaml
    #changlog生效的上下文
    contexts: dev
    #第一次执行时，是否清空数据库
    drop-first: true
    #changelog生效的标签
    labels: dev

3. 在resource文件夹下创建db/changelog/changelog.yaml文件，然后填充以下内容

databaseChangeLog:
  - includeAll:
      path: db/changelog/sql/

4. 然后就可以在db/changelog/sql/文件夹创建你自己的changeset sql格式的文件了；建议文件的命令使用有意义的版本和名字进行命名，比如：01-01-modify-user-table.sql。
5. sql文件样例

-- liquibase formatted sql

--changeset liming:1 ranOn: 2019-07-01 11:00:00.000000000 +0000
create table user
(
    id   bigint auto_increment
        primary key,
    name varchar(255) not null
);

--changeset liming:2 ranOn: 2019-07-01 11:00:00.000000000 +0000
insert into user (name) values ('liming');

6. 部署changelog
   6.1.直接启动程序就可以实现改变
   6.2. 在pom.xml中添加liquibase-maven-plugin插件，使用提供的update功能可以实现改变