Apache DolphinScheduler 3.2.2版本MySQL升级脚本语法问题解析

在Apache DolphinScheduler 3.2.2版本中，当用户从3.1.5版本升级时，执行MySQL数据库升级脚本过程中可能会遇到SQL语法错误。这个问题主要出现在3.2.0_schema升级路径下的dolphinscheduler_dml.sql文件中。

问题现象

当用户按照标准升级流程执行以下命令时：

mysql < dolphinscheduler_ddl.sql
mysql < dolphinscheduler_dml.sql

系统会报出如下错误信息：

ERROR 1064 (42000) at line 34: You have an error in your SQL syntax...

问题根源分析

经过深入分析，发现问题出在dolphinscheduler_dml.sql文件中的存储过程定义部分。原始脚本在定义存储过程时，delimiter切换逻辑存在缺陷，导致MySQL解析器无法正确识别SQL语句边界。

具体来说，原始脚本尝试在同一行中连续执行多个操作：

1. 切换delimiter
2. 创建存储过程
3. 执行存储过程
4. 删除存储过程

这种紧凑的写法在某些MySQL版本中会导致语法解析错误。

解决方案

正确的脚本应该采用以下结构：

-- 首先确保存储过程不存在
DROP PROCEDURE IF EXISTS dolphin_t_ds_tenant_insert_default;

-- 切换delimiter以正确定义存储过程
delimiter d//

-- 创建存储过程
CREATE PROCEDURE dolphin_t_ds_tenant_insert_default()
BEGIN
    IF NOT EXISTS(SELECT 1 FROM t_ds_tenant WHERE id = -1) THEN
        INSERT INTO `t_ds_tenant` VALUES ('-1', 'default', 'default tenant', '1', current_timestamp, current_timestamp);
    END IF;
END;
d//

-- 恢复默认delimiter
delimiter ;

-- 更新管理员租户信息
UPDATE `t_ds_user` SET `tenant_id` = '-1' WHERE (`user_name` = 'admin') AND (`tenant_id` = '0');

-- 调用并清理存储过程
CALL dolphin_t_ds_tenant_insert_default();
DROP PROCEDURE dolphin_t_ds_tenant_insert_default;

技术要点说明

1. 存储过程管理：在创建存储过程前先检查并删除同名存储过程，避免冲突。

2. delimiter使用：在定义包含分号的存储过程体时，必须临时修改delimiter，确保MySQL能正确识别存储过程的开始和结束位置。

3. 租户默认值处理：这个存储过程的核心功能是确保系统中存在一个ID为-1的默认租户记录，这对于系统正常运行至关重要。

4. 管理员账户处理：脚本中还包含了对管理员账户租户信息的更新，确保管理员账户与默认租户正确关联。

最佳实践建议

1. 在执行升级脚本前，务必备份数据库。

2. 建议先在测试环境验证升级过程，确认无误后再在生产环境执行。

3. 对于大型生产环境，可以考虑分步执行脚本，而不是直接通过重定向输入方式执行。

4. 关注官方发布的升级说明和已知问题，及时获取最新修复方案。

这个问题已经在后续版本中得到修复，但理解其原理对于处理类似数据库升级问题仍有参考价值。