liquibase changelog文件

Liquibase Changelog 文件详解与使用

最新推荐文章于 2025-07-21 09:15:00 发布

原创最新推荐文章于 2025-07-21 09:15:00 发布 · 4.9k 阅读

4 ·

CC 4.0 BY-SA版权

Liquibase 专栏收录该内容

3 篇文章

订阅专栏

本文介绍了Liquibase在执行变更日志时如何操作DATABASECHANGELOG和DATABASECHANGELOGLOCK表，以及如何处理已执行的changeSet。当遇到'Waiting for changelog lock...'信息时，可能是因为数据库锁表。接着，文章详细解析了databaseChangeLog文件结构，包括<changeSet>、<include>和<includeAll>标签的用法，并提供了示例。

1.LiquiBase在执行changelog时，会在数据库中插入两张表：DATABASECHANGELOG和DATABASECHANGELOGLOCK，分别记录changelog的执行日志和锁日志。

LiquiBase在执行changelog中的changeSet时，会首先查看DATABASECHANGELOG表，如果已经执行过，则会跳过（除非changeSet的runAlways属性为true），如果没有执行过，则执行并记录changelog日志；

或者可是在databasechangelog表中删除这条changeset的执行记录，然后再执行这个changeset

2.liquibase 运行中出现 INFO … Liquibase: Waiting for changelog lock....是有机器锁表了 参考数据库重构工具 LiquiBase(5 Liquibase被锁)

--查看哪个机器锁表
SELECT * FROM DATABASECHANGELOGLOCK;

--如果是本机锁表，解锁语句
UPDATE DATABASECHANGELOGLOCK SET locked=0, lockgranted=null, lockedby=null WHERE id=1

3. <databaseChangeLog>文件结构

3.1<changeSet>标签指路常用到的一些 changeset

3.2. <include>与<includeAll>标签

<include>的file属性表示要包含的changelog文件的路径，这个文件可以是LiquiBase支持的任意格式，

relativeToChangelogFile如果为true，则表示file属性表示的文件路径是相对于根changelog 而不是CLASSPATH的，默认为false。

例如如下sql文件 201908091500_T_TABLE_NAME.sql

-- liquibase formatted sql
-- changeset ds:201908091500_T_TABLE_NAME.T_TABLE_NAME failOnError:true dbms:oracle
ALTER TABLE T_TABLE_NAME ADD NEW_COLUMN NUMBER(6);

<include file="201908091500_T_TABLE_NAME.sql" relativeToChangelogFile="true" />

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

<includeAll path="com/example/changelogs/"/>

4.new一个databaseChangeLog文件 new 201908091500_T_TABLE_NAME_DDL 的xml文件

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<databaseChangeLog xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
	xmlns:ext="http://www.liquibase.org/xml/ns/dbchangelog-ext" 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.4.xsd http://www.liquibase.org/xml/ns/dbchangelog-ext http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-ext.xsd">
 
	<changeSet author="ds" id="201908091500_T_TABLE_NAME_DDL-1">
	
	</changeSet>
    <include file="201908091500_T_TABLE_NAME.sql" relativeToChangelogFile="true" />
</databaseChangeLog>