H2数据库SQL语法解析：UNION ALL与FETCH ROWS ONLY的兼容性问题分析

背景概述

在H2数据库的使用过程中，开发者发现了一个SQL语法解析的特殊现象：当尝试将FETCH ... ROWS ONLY子句与UNION ALL操作符结合使用时，如果不使用括号包裹查询语句，系统会抛出语法错误。这一现象引发了关于SQL标准合规性和语法解析规则的深入讨论。

问题现象

具体表现为以下两种SQL语句的执行差异：

-- 错误示例（抛出语法错误）
select 1 fetch first 1 rows only
union all select 1 fetch first 1 rows only

-- 正确示例（正常执行）
(select 1 fetch first 1 rows only)
union all 
(select 1 fetch first 1 rows only)

技术解析

SQL标准规范

根据SQL:2016标准，查询表达式(<query expression>)的结构定义如下：

1. 可选的WITH子句
2. 查询表达式主体
3. 可选的ORDER BY、OFFSET和FETCH子句

查询表达式主体可以是查询项(<query term>)，或者是另一个查询表达式主体后接UNION/EXCEPT和查询项。而查询项又可以是查询主项(<query primary>)或另一个查询项后接INTERSECT和查询主项。

语法树结构

关键点在于查询主项的定义：

• 简单表
• 带括号的查询表达式主体（内部可包含ORDER BY、OFFSET和FETCH子句）

这意味着FETCH子句在语法上只能附加在查询主项或完整查询表达式之后，而不能直接附加在UNION ALL操作的部分查询上。

H2实现分析

H2数据库采用递归下降解析器(Recursive Descent Parser)来实现SQL语法解析。这种解析器对语法规则的顺序和结构非常敏感。当前的语法规则实现严格遵循了SQL标准，因此当遇到未加括号的UNION ALL结合FETCH子句时会报错。

解决方案

开发者需要明确：

1. 当使用集合操作(UNION/INTERSECT/EXCEPT)时
2. 若需要对部分结果集使用FETCH/OFFSET限制
3. 必须使用括号明确界定查询边界

这种设计实际上提高了SQL语句的明确性，避免了可能产生的二义性。

扩展知识

值得注意的几点：

1. 这种语法限制不是H2特有的，而是符合SQL标准的实现
2. 大多数现代数据库系统都遵循类似的解析规则
3. 括号的使用不仅解决语法问题，还能提高代码可读性
4. 在复杂查询中，明确的查询边界定义有助于优化器生成更好的执行计划

最佳实践建议

对于开发者而言，建议：

1. 在组合多个查询时始终考虑使用括号
2. 将FETCH/OFFSET子句视为查询的最终操作步骤
3. 在编写复杂查询时，先测试各个子查询部分
4. 注意不同数据库系统间可能存在的细微语法差异

通过理解这些底层语法规则，开发者可以编写出更健壮、更符合标准的SQL语句，避免在数据库迁移或系统升级时遇到兼容性问题。