Liquibase学习4 - 管理changelog

嗯嗯__
471 阅读9分钟

文章目录

Changelog

不同格式类型的Changelog能力支持

在这里插入图片描述

更改类型：ChangeType（由Liquibase定义的DDL语句）

官网： docs.liquibase.com/change-type…

作用： 其实就是Liquibase定义的节点，让其同一种语句支持种数据库的部署，如使用liquibase定义的，不使用数据库本身的DDL语句CREATE TABLE ，因为这种DDL语句可能仅适用你当前所需部署的数据库，而不支持如mongoDB这些数据库，让官方定义的内部自动转成mongodDB支持的语句

changeSet

changeSet节点的属性

概述

全部的属性节点查看官网： docs.liquibase.com/concepts/ch…

在这里插入图片描述

labels - 标签名、组名 - 有部署权限建议使用这个

特别注意： 复杂的匹配表达式逻辑是写在命令行参数–labels上，而changeSet节点的labels是不可以写表达式逻辑只能是 “标签名1,标签名2,标签名3” - 所以我就为什么说labels适合无部署权限的人使用

 

官网： docs.liquibase.com/concepts/ch…

作用： 提供了对其变更集进行分组和分类的能力，以控制执行哪些变更集。在 Liquibase 执行期间，可以提供一个标签表达式，该表达式将充当过滤器，以精确控制将执行哪些变更集

使用0： 符合标签表达式的hangeSet节点才可以被liquibase部署运行
使用1： changeSet节点的属性labels定义当前变更节点所属于的标签名
使用2： iquibase update --labels=标签表达式 或者 liquibase update --labelFilter=标签表达式，用于说明什么标签名的结果集需要被执行。但如果–labels、–labelFilter不定义则默认全部执行，无需过滤操作

注意： --labelFilter这个参数最新的liquibase版本已经被剔除了，所以只用–labels即可

//帮助文档
liquibase update --help

//符合的标签才进行部署的数据库中
liquibase update --label="标签表达式"

//最新版本--labelFilter已经不支持，不要使用
liquibase update --labelFilter="标签表达式"

 

讲解

<!--这个变更节点有两个标签名即20220713以及v1-->
<changeSet id="2" author="LinRuChang" labels="20220713,v1" >

        <comment>创建表user_20220713_v1</comment>
        <sql>
            CREATE TABLE `user_20220713_v1`
            (
                `id`          char(32) CHARACTER SET utf8 COLLATE utf8_bin        NOT NULL COMMENT '主键',
                `name`        varchar(255) CHARACTER SET utf8 COLLATE utf8_bin DEFAULT NULL COMMENT '角色名',
                PRIMARY KEY (`id`) USING BTREE
            ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin COMMENT='liquibase测试表'
        </sql>
        <rollback>
            <comment>删除表</comment>
            <dropTable tableName="user_20220713_v1"></dropTable>
        </rollback>
    </changeSet>

过滤节点讲解

# 仅部署执行 标签名【同时是v1和20220713的changeset节点】或者 【标签名不是v1的节点】或者 【没有设置labels属性的changeset节点】
liquibase update --labels="(v1 and 20220713) or (not v1)"

 
在这里插入图片描述

context - 上下文 - 无部署权限的建议使用这个

特别注意： 复杂的匹配表达式逻辑是写在changeSet节点的context属性上的，而命令行参数–labels上是不可以写表达式逻辑只能是 “上下文名1,上下文名2,上下文名3” 这种值格式 - 所以我就为什么说context适合有部署权限的人使用

 

官网： docs.liquibase.com/concepts/ch…

作用： 提供了对其变更集进行分组和分类的能力，以控制执行哪些变更集。在 Liquibase 执行期间，可以提供一个上下文表达式，该表达式将充当过滤器，以精确控制将执行哪些变更集

使用0： 符合上下文表达式的hangeSet节点才可以被liquibase部署运行
使用1： changeSet节点的属性context定义当前变更节点所属于的上下文名
使用2： iquibase update --contexts=“上下文名1,上下文名2,上下文名3” ，用于说明什么上下文名的结果集需要被执行。但如果–contexts不定义则默认全部执行，无需过滤操作

//帮助文档
liquibase update --help

//符合的标签才进行部署的数据库中
liquibase update --contexts="上下文名1,上下名2"

 

讲解

    <!--输入的命令行参数context,同时有v2  v2lrc  20220713三个名字，则会执行-->
    <changeSet id="3" author="LinRuChang" context="20220713 and v2 and v2lrc" >
        <comment>创建表user_20220713_v2_v2lrc</comment>
        <sql>
            CREATE TABLE `user_20220713_v2_v2lrc`
            (
                `id`          char(32) CHARACTER SET utf8 COLLATE utf8_bin        NOT NULL COMMENT '主键',
                `name`        varchar(255) CHARACTER SET utf8 COLLATE utf8_bin DEFAULT NULL COMMENT '角色名',
                PRIMARY KEY (`id`) USING BTREE
            ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin COMMENT='liquibase测试表'
        </sql>
        <rollback>
            <comment>删除表</comment>
            <dropTable tableName="user_20220713_v2_v2lrc"></dropTable>
        </rollback>
    </changeSet>

    <!--输入的命令行参数context,无v2名字，则会执行-->
    <changeSet id="5" author="LinRuChang" context="not v2" >
        <comment>创建表user_20220713_not_v2</comment>
        <sql>
            CREATE TABLE `user_20220713_not_v2`
            (   
                `id`          char(32) CHARACTER SET utf8 COLLATE utf8_bin        NOT NULL COMMENT '主键',
                `name`        varchar(255) CHARACTER SET utf8 COLLATE utf8_bin DEFAULT NULL COMMENT '角色名',
                PRIMARY KEY (`id`) USING BTREE
            ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin COMMENT='liquibase测试表' 
        </sql>
        <rollback>
            <comment>删除表</comment>
            <dropTable tableName="user_20220713_not_v2"></dropTable>
        </rollback>
    </changeSet>

    <!--输入的命令行参数context,有v2或v2lrc或20220713名字，则会执行-->
    <changeSet id="4" author="LinRuChang" context="20220713 or v2 or v2lrc" >
        <comment>创建表user_20220713_v2_v2lrc_or</comment>
        <sql>
            CREATE TABLE `user_20220713_v2_v2lrc`
            (   
                `id`          char(32) CHARACTER SET utf8 COLLATE utf8_bin        NOT NULL COMMENT '主键',
                `name`        varchar(255) CHARACTER SET utf8 COLLATE utf8_bin DEFAULT NULL COMMENT '角色名',
                PRIMARY KEY (`id`) USING BTREE
            ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin COMMENT='liquibase测试表' 
        </sql>
        <rollback>
            <comment>删除表</comment>
            <dropTable tableName="user_20220713_v2_v2lrc"></dropTable>
        </rollback>
    </changeSet>

过滤节点讲解

# 仅部署执行 上下文名是20220713或v1的以及没有定义context属性的changeset节点
liquibase update-sql --contexts="20220713,v1"

在这里插入图片描述

runOnChange - 变更集changeset节点内容修改时是否重新执行

官网： docs.liquibase.com/concepts/ch…

可能场景使用建议： 有些情况下存储过程（虽然不常用）的内容逻辑发生变更，可以定义使用该属性让其一旦内容跟发生变化则重新部署运行，而不需新起一个changeset节点部署运行

重新执行成功后： 在databasechangelog表根据ID、AUTHOR、FILENAME的值找到对应行记录修改其中的DATEEXECUTED、ORDEREXECUTED、EXECTYPE、MD5SUM、DEPLOYMENT_ID这几个列

在这里插入图片描述

runAlways - 每次部署该changeset节点都会运行，不管之前是否以部署过

官网： docs.liquibase.com/concepts/ch…

注意： 如果你需要每次部署的执行，且该changeset的部署内容会发生变更，请将runAlways、runOnChange都设置为true，否则一旦你内容变化，则会导致当前changset内容md5跟之前部署不一致，导致后续的liquibse节点部署失败

在这里插入图片描述

runOrder - 当前changeset节点放置在开头或者最后执行

小知识： 官方说一般配合runAlways使用，当然不配合也是可以

在这里插入图片描述

changeSet的子节点

preConditions

官网： docs.liquibase.com/concepts/ch…

preConditions的属性
preConditions所有支持的子节点查看

官网： docs.liquibase.com/concepts/ch…

在这里插入图片描述

子节点：changeSetExecuted

官网： docs.liquibase.com/concepts/ch…

作用： 指定的更改集是否已被执行。

<preConditions onFail="HALT">
    <changeSetExecuted id="1" author="liquibase" changelog-file="changelog.xml" />
</preConditions>

在这里插入图片描述

子节点：sqlCheck

官网： docs.liquibase.com/concepts/ch…

作用： 执行一个SQL字符串并检查返回值。SQL结果必须是单行单列的数据

<preConditions onFail="WARN">
    <sqlCheck expectedResult="1">
        SELECT COUNT(1) FROM pg_tables WHERE TABLENAME = 'myRequiredTable'
    </sqlCheck>
</preConditions>

在这里插入图片描述

最佳实践

changelog文件如何拆分更好的管理

官方： learn.liquibase.com/unit/view/i…

注意： 划分的模块，使用 ******或 ******进行将所有切割changelog模块组织起来

划分-版本号

在这里插入图片描述

划分-功能模块

在这里插入图片描述

划分-功能模块+功能模块结合

在这里插入图片描述

changelog太大且生产部署了多次，即将拆分重构changelog文件

风险

文章： learn.liquibase.com/unit/view/i…

方式1 - 学会使用databaseChangeLog的logicalFilePath属性

官网： docs.liquibase.com/concepts/ch…

在这里插入图片描述

方式2 - 不管以前的changelog文件，从此时此刻前按组分规定的拆分规范进行组织changelog文件的引入

意义： 由于拆分历史臃肿庞大的changelog文件，比较费时费力（要做足够多的测试），毕竟涉及到数据库的变更，历史的东西能不动就不动。但是如果你的changelog文件不是很臃肿，当然还是建议你按组内新的规范进行拆分为好，方便后续维护。

liquibase运行部署太慢

小贴士： 官方说自己的liquibase产品效率足够快，liquibase部署的慢很可能是使用者自身的问题

可能原因
优化
优化1：删除不必要的changeset节点

案例： 例如：一个changset节点是创表a，另一个是删除a，其实两者一合起来就是啥都没做，可以考虑将这两个changeset节点直接从xml删掉即可

 

优化2：合并历史changset节点 - 学会使用validCheckSum节点或clear-checksums命令

官网validCheckSum： docs.liquibase.com/concepts/ch…

官网clear-checksums： docs.liquibase.com/commands/ma…

案例： 例如changelog文件中有3个历史changeset节点，一个是创空表a，一个是在a中加字段B，一个是在a中加字段C，可以将这3个changeset合并一个changeset，即创表的时候就增加字段B、C即可

使用节点进行删除合并
在这里插入图片描述

 

 

使用clear-checksums命令进行删除合并 = 这个更简单

在这里插入图片描述

多模式（Schema）部署 - 即不同的数据库名

理念： 将不同的数据库名的单独作为一个xml管理，且设置context用来标记这个XML部署到哪个数据库的，最后liquibase update部署运行的时候需要指定 --contexts 采用哪个changelog文件运行 以及 -default-schema-name 或者 --default-catalog-name 指定部署的数据库名

 

iquibase.bat update --contexts="lrc_blog2" --defaultSchemaName="lrc_blog2"

 
lrc_blog1-changelog.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"
        xmlns:pro="http://www.liquibase.org/xml/ns/pro"
        xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
		http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-latest.xsd
		http://www.liquibase.org/xml/ns/dbchangelog-ext http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-ext.xsd
		http://www.liquibase.org/xml/ns/pro http://www.liquibase.org/xml/ns/pro/liquibase-pro-latest.xsd"
        context="lrc_blog3"
>

    <changeSet id="0" author="lrc" >
        <tagDatabase tag="blog3_version"></tagDatabase>
    </changeSet>

    <changeSet id="1" author="lrc" >
        <createTable tableName="user3">
            <column name="id" type="int" remarks="主键">
                <constraints primaryKey="true"></constraints>
            </column>
            <column name="year" type="int" remarks="年龄"></column>
        </createTable>
    </changeSet>

</databaseChangeLog>

 
在这里插入图片描述

avatar
文章
阅读
粉丝