【Liquibase】基础概念 + demo实战-CSDN博客

 `<!
        <dependency>
            <groupId>org.liquibase</groupId>
            <artifactId>liquibase-core</artifactId>
            <version>4.9.1</version>
        </dependency>` 



复制

在 src/main/resources 创建目录 db， db 目录用来存放 Liquibase 相关的 changelog 文件。
在 db/changelog 目录下创建 changelog-master.xml 文件，该文件为主配置文件，作用就是引入所有模块的 changelog 文件：
有更新时新增 include 标签和对应的文件即可。
指向changelog或文件夹的顺序是非常重要的。它需要告知Liquibase在运行SQL时的顺序。我们最好先运行changelog(其中包含了“create table(…)”)，然后再运行使用该表的编译包。

`<?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"
  xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
  http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-3.1.xsd">

  
  <include file="/sql/001_create_person_table.sql" relativeToChangelogFile="true"></include>
	
  <changeSet id="T100-20221009-001" author="txg">
      <sqlFile path="/db/changelog/sql/002_create_person1_table.sql"></sqlFile>
  </changeSet>
  
</databaseChangeLog>` 

![[59ddd7af80665f17c019602d722bf0e2_MD5.png]]



复制

在 src/main/resources/db 创建目录 changelog/sql，用来存放数据库脚本文件；
例如，创建 001_create_person_table.sql 文件

• 每个sql文件必须以-- liquibase formatted sql注释开头
• 每个changeset必须以–changeset author:id注释开头

 `insert into departments values(1, '研发部');
insert into departments values(2, '销售部');

insert into departments values(3, '后勤部');

DELETE FROM departments WHERE DEPARTMENT_NAME = '研发部'` 


复制

配置开启 liquibase，并指定主文件的路径

`spring:
  datasource:
    url: jdbc:oracle:thin:@172.20.0.7:1521:ctsdb
    driver-class-name: oracle.jdbc.driver.OracleDriver
    username: CTS_DEV
    password: CTS_DEV
  liquibase:

    enabled: true

    change-log: classpath:/db/changelog/changelog-master.xml

    drop-first: false

server:
  port: 8088` 

复制

成功执行sql文件里的脚本：

`public static void main(String[] args) {
    String dbUrl = "jdbc:oracle:thin:@172.20.0.7:1521:ctsdb";
    String changeLogFile = "classpath:/db/changelog/changelog-master1.xml";
    String dbUsername = "CTS_DEV";
    String dbPassWord = "CTS_DEV";
    
    liquiBaseStart(dbUrl,dbUsername,dbPassWord,changeLogFile);
}

    public void liquiBaseStart(String dbUrl,String dbUsername,String dbPassWord,String changeLogFile)  {

        
        try {
            Class.forName("oracle.jdbc.driver.OracleDriver");
            
            Connection connection = DriverManager.getConnection(dbUrl, dbUsername, dbPassWord);
            JdbcConnection jdbcConnection = new JdbcConnection(connection);
            
            Liquibase liquibase = new Liquibase(changeLogFile, new ClassLoaderResourceAccessor(), jdbcConnection);
            
            liquibase.update("");
            connection.close();
        } catch (ClassNotFoundException e) {
            throw new RuntimeException(e);
        } catch (SQLException e) {
            throw new RuntimeException(e);
        } catch (LiquibaseException e) {
            throw new RuntimeException(e);
        }
    }` 


复制

配置数据库连接信息和Liquibase生成规则配置。

`<!
<plugin>
    <groupId>org.liquibase</groupId>
    <artifactId>liquibase-maven-plugin</artifactId>
    <version>3.5.1</version>
    <configuration>
        <propertyFile>src/main/resources/db/liquibase.properties</propertyFile>
        <propertyFileWillOverride>true</propertyFileWillOverride>
        <outputChangeLogFile>src/main/resources/liquibase/changelog/changelog_init.xml</outputChangeLogFile>
    </configuration>
</plugin>` 

复制

1. 每个发布新建一个文件夹，所有发布相关的 ChangeSet 文件以及数据初始化文件，均放在些文件夹中。
2. 每个发布新建一个 master.xml。此 master.xml 中，include 本次发布需要执行的 ChangeSet 文件
3. 根据开发小组独立 ChangeSet文件(可选)
4. 根据功能独立 ChangeSet 文件。例如 user.xml, company.xml

`esources
  |-liquibase
    |-user
    | |- master.xml
    | |- release.1.0.0
    | | |- release.xml
    | | |- user.xml -- 用户相关表ChangeSet
    | | |- user.csv -- 用户初始化数据
    | | |- company.xml -- 公司相关表ChangeSet
    | |- release.1.1.0
    | | |- release.xml
    | | |- ...` 

复制

首先说明一下 Spring Boot 中 Liquibase 默认是如何执行以及执行结果。

1. 在启动时，LiquibaseAutoConfiguration 会根据默认配置初始化 SpringLiquibase
2. SpringLiquibase.afterPropertiesSet()中执行 ChangeSet 文件
3. 第一次跑 ChangeSets 的时候，会在数据库中自动创建两个表databasechangelog和databasechangeloglock

因此我们可以认为一个 SpringLiquibase 执行为一个模块。
引入多模块管理时，基于上节文件管理规范，我们基于模块管理再做下调整。

`resources
  |-liquibase
    |-user
    | |- master.xml
    | |- release.1.0.0
    | | |- release.xml
    | | |- user.xml -- 用户相关表ChangeSet
    | | |- user.csv -- 用户初始化数据
    | | |- company.xml -- 公司相关表ChangeSet
    | |- release.1.1.0
    | | |- release.xml
    | | |- ...
    |- order
    | |- master.xml
    | |- release.1.0.0
    | | |- ...` 


复制

如果启动服务时，控制台提示如下信息：
Liquibase - Waiting for changelog lockWaiting for changelog lock....
通常是由于 Liquibase 在重构数据库时使数据库死锁。解决方法如下：
1 查看锁住数据库的id：
SELECT * FROM DATABASECHANGELOGLOCK where LOCKED = true;
2 解锁：
UPDATE DATABASECHANGELOGLOCKSET locked=0, lockgranted=null, lockedby=nullWHERE id={id}
{id} 为第一步中查询出来对应记录的id。

liquibase 在处理 changeset 的时候, 会先计算校验和并将其存储到 DATABASECHANGELOG 这个表中. 在 changeset 运行之后, 如果 changeset 有任何修改 liquibase 都能通过对比校验和感知到.
如果已经运行的 changeset 发生了修改, 会导致校验和变化,liquibase 会退出执行并且报错:
Validation failed: change set check sums <changeset identifer> was: <old checksum> but is now: <newchecksum>.
这是因为 liquibase 不知道你做了哪些变更. 如果确实是 changeset 需要修改, 而你又想忽略这个错误, 有两个选择：

手动修改 DATABASECHANGELOG 中的记录
第一个方法是手动修改 DATABASECHANGELOG 这个表中对应的记录, 可以将其设置为空值. 这个应该在所有的环境都被部署之后进行. 下次你再运行 liquibase 的时候, 将会更新 checksum 到正确的新值.

属性
第二个方法是给 changeset 增加一个 元素. 这个文本将原来报错的 md5 放到这里来.

runOnChange 属性
校验和通常会和 changeSet 的 runOnChange 属性结合使用. 有时候你并不想增加新的 changeset, 因为只需要知道当前版本, 但是你又想每次更新的时候使用.
runOnChange 默认是 false 的. 如果将其设置为 true 的话, 那么只要 changeset 有更新则会执行.