Liquibase 的 onFail: CONTINUE 为何未跳过约束删除?
将 preConditions 放到需要跳过的 changeSet 内,并在其中配置 onFail: CONTINUE。你贴出的前置条件位于 databaseChangeLog 层级,无法用来按条件跳过单个 changeset。
为什么会出现 ValidationFailedException?
Liquibase 区分 changelog 级和 changeset 级前置条件。changelog 级前置条件在 changeset 执行前检查,在该层级配置 onFail: CONTINUE,无法实现“跳过当前 changeset 并继续”。应将该值放在 changeset 的前置条件中。Liquibase 前置条件文档
日志显示失败的是 uniqueConstraintExists 检查,不能据此认定 Liquibase 已执行了 dropUniqueConstraint。
你贴出的 YAML 没有显示必要的嵌套缩进。实际文件中,onFail 和 uniqueConstraintExists 都必须属于 preConditions,约束参数也必须属于对应的检查或变更。
如何修改 YAML?
在支持 uniqueConstraintExists 的 Liquibase 版本和支持该删除操作的数据库中,可以这样配置:
databaseChangeLog:
- objectQuotingStrategy: QUOTE_ONLY_RESERVED_WORDS
- changeSet:
id: 000.2605121336__DropUniqueConstraintFromPersonName
author: db_admin
preConditions:
- onFail: CONTINUE
- uniqueConstraintExists:
constraintName: person_name_key
schemaName: ${schema}
tableName: person
changes:
- dropUniqueConstraint:
constraintName: person_name_key
schemaName: ${schema}
tableName: person
uniqueColumns: name
示例通过约束名称检查是否存在,因此移除了检查中的 uniqueColumns: name。如果按列检查,uniqueConstraintExists 的参数名是 columnNames,不能直接套用 dropUniqueConstraint 的参数。uniqueConstraintExists 参数说明
删除操作中仍保留了 uniqueColumns: name。该参数有数据库适用范围,官方将其用于 SAP SQL Anywhere 的 UNIQUE 列列表,应根据实际数据库确认是否需要保留。dropUniqueConstraint 参数说明
CONTINUE 和 MARK_RAN 应该选哪个?
对于 changeset 级前置条件:
CONTINUE:条件失败时跳过该 changeset,继续处理后续变更;下次更新时仍会重新尝试。MARK_RAN:条件失败时跳过实际操作,并将该 changeset 标记为已执行;后续通常不会再次尝试。
如果约束不存在时只想暂时跳过,使用 CONTINUE。如果这次迁移的目标是确保约束不存在,且确认以后无需重试,可以考虑 MARK_RAN。WARN 会继续执行变更,不能用于保护这次删除操作。onFail 行为说明
修改后仍有问题时检查什么?
确认 ${schema} 已解析为目标 schema,检查和删除使用的表名、约束名及 schema 也一致。如果数据库中确实存在该约束,再核对连接目标、名称大小写,以及当前用户读取元数据的权限。
onFail 处理检查结果不满足条件的情况;检查过程本身抛出异常则属于 onError。应先确认异常原因,不要仅为绕过异常就设置 onError: CONTINUE。原始材料没有提供 Liquibase 版本和数据库类型,无法判断是否还存在兼容性问题。
备注:内容仅供参考。
