Jenkins执行Teradata宏脚本报Error 3707语法错误如何解决

问题现象 #

通过Jenkins调度Liquibase执行Teradata宏定义脚本时抛出异常，核心错误信息为：

liquibase.exception.DatabaseException: [Teradata Database] [TeraJDBC 17.00.00.03] [Error 3707] [SQLState 42000] Syntax error, expected something like ')' between ';' and the end of the request.

涉及的原始宏定义脚本如下：

REPLACE MACRO Macroname
(
col1 TIMESTAMP(0)
)
AS
(  
    DELETE FROM
        tabe1
    WHERE td_colnm = 'Jenkins';
);

根因分析 #

该报错由两类问题共同触发：

• Teradata宏语法不符合规范：Teradata宏定义中，宏体内部的SQL语句末尾不能直接书写;，;是整个宏定义请求的结束标识，需要放在宏体闭合括号的外侧。原始脚本将分号写在DELETE语句末尾、宏的右括号之前，Teradata解析到该分号时会判定宏定义提前结束，后续的右括号会被识别为非法冗余内容，触发语法报错。
• Liquibase默认规则截断SQL：Liquibase默认以;作为单条SQL的拆分标记，读取到DELETE语句后的分号时，会直接把前半段内容判定为完整SQL发送给Teradata，不会携带后续的宏闭合括号、结束标记，报错日志中截断的SQL片段也能印证语句被提前截断的问题。

可行解决方案 #

• 修正宏本身的语法错误：删除宏体内部DELETE语句末尾的分号，保证宏结构符合Teradata语法要求，修正后的宏代码如下：

REPLACE MACRO Macroname
(
col1 TIMESTAMP(0)
)
AS
(  
    DELETE FROM
        tabe1
    WHERE td_colnm = 'Jenkins'
);

• 调整Liquibase的分隔符配置：针对宏、存储过程这类包含多段逻辑的Teradata对象定义，不要使用默认的;作为脚本拆分标识，在对应changeSet中显式指定结束分隔符为Teradata官方推荐的/，避免Liquibase提前截断语句，配置示例如下：

<changeSet id="replace_macro_001" author="dev">
    <sql endDelimiter="/">
        REPLACE MACRO Macroname
        (
        col1 TIMESTAMP(0)
        )
        AS
        (  
            DELETE FROM
                tabe1
            WHERE td_colnm = 'Jenkins'
        );
        /
    </sql>
</changeSet>

• 提交前做本地语法校验：脚本上传到Jenkins流水线前，先通过Teradata Studio、BTEQ等官方客户端验证宏定义可正常编译执行，提前排查基础语法问题。

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