使用Liquibase执行含子SQL文件的main.sql时遇格式无效错误求助

问题描述 #

执行包含子SQL文件的main.sql时，Liquibase抛出"invalid format"错误，相关SQL代码如下：

--liquibase formatted SQL
--changeset dev:1 runOnChange:true splitStatements:true stripComments:false runAlways:false  labels:new-label context:example-context
--comment: For main SQL file

@createtable2.sql
/
@createtable3.sql
/

commit
/

问题原因 #

1. Liquibase的格式化SQL模式不支持@filename.sql这种引入外部文件的语法——这是SQL*Plus等数据库客户端的专属语法，Liquibase无法解析，直接触发格式错误。
2. splitStatements:true配置下，用/作为语句分隔符会和Liquibase的语句拆分逻辑冲突，进一步加剧格式识别问题。

解决方案 #

替换引入语法为Liquibase支持的--include指令 #

把@filename.sql替换成Liquibase官方支持的--include file:xxx.sql语法，同时移除多余的/分隔符：

修改后的main.sql代码：

--liquibase formatted SQL
--changeset dev:1 runOnChange:true splitStatements:true stripComments:false runAlways:false  labels:new-label context:example-context
--comment: For main SQL file

--include file:createtable2.sql
--include file:createtable3.sql

commit;

额外注意事项 #

• 子SQL文件需和main.sql处于同一目录，若不在同一目录，需指定相对路径（如--include file:./subdir/createtable2.sql）或绝对路径。
• 如果子SQL文件仅包含纯数据库语句，无需添加Liquibase相关注释；若子文件也包含Liquibase指令，需确保其格式完全符合Liquibase的要求。

内容的提问来源于stack exchange，提问作者praveenazuredevops