升级至HSQLDB 2.7.4时命名为Index的列报错问题

一、ALTER语句报错的解决方法 #

报错核心原因是Index是HSQLDB 2.7.4版本的保留关键字，直接作为列名使用会触发语法解析异常。即便启用sql.syntax_mys=true，部分核心保留字仍无法直接使用，可通过两种方式解决：

1. 用双引号包裹列名（HSQLDB支持通过双引号转义保留字）：

ALTER TABLE abc ADD "Index" INT DEFAULT 0 NOT NULL

2. 修改列名为非保留字（更推荐，规避后续潜在兼容性问题）：

ALTER TABLE abc ADD idx INT DEFAULT 0 NOT NULL

二、HSQLDB 2.4.1 → 2.7.4升级的特殊步骤 #

除替换jar包和逐个修复语法问题外，还需关注以下关键操作：

• 数据库文件升级与优化：启动新版本HSQLDB时，它会自动检测旧版本数据库文件并执行格式升级，建议启动后执行SHUTDOWN COMPACT命令，完成文件结构优化，避免后续性能损耗。
• 全量数据备份：升级前务必对所有数据库文件（.script、.data、.log等）做完整备份，防止升级异常导致数据丢失。
• 清理废弃配置：对照官方文档，移除或替换2.4.1版本中已被废弃的配置参数，部分旧语法兼容参数在新版本中行为可能发生调整。
• 验证自定义逻辑：若数据库存在自定义存储过程、触发器、函数，需逐一测试运行状态——新版本对PL/SQL兼容逻辑、内置函数行为可能有细微改动。
• 核心SQL兼容性测试：针对业务关键SQL（查询、写入、修改语句）做全覆盖测试，确认新版本对旧语法的支持情况，比如某些隐式类型转换在新版本中会更严格。

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