SQL Formatter项目中的PLSQL MINUS操作符格式化问题解析

SQL Formatter项目中的PLSQL MINUS操作符格式化问题解析

sql-formatter 项目地址: https://gitcode.com/gh_mirrors/sqlf/sql-formatter

在SQL Formatter项目中，最近发现了一个关于PLSQL方言中MINUS操作符格式化处理的bug。这个问题影响了SQL语句在格式化工具中的正确呈现，特别是当使用MINUS集合操作符时。

问题背景

SQL Formatter是一个广泛使用的SQL代码格式化工具，支持多种SQL方言。在PLSQL方言中，MINUS操作符用于执行集合差运算，类似于T-SQL中的EXCEPT操作符。然而，在格式化处理过程中，工具未能正确识别和处理PLSQL中的MINUS操作符。

问题表现

当用户输入包含MINUS操作符的PLSQL查询时，格式化后的输出会出现不理想的排版。具体表现为MINUS操作符与前面的FROM子句紧贴在一起，而不是像其他集合操作符（如UNION）那样单独成行。

技术分析

问题的根源在于PLSQL格式化配置文件中缺少对MINUS操作符的正确定义。在plsql.formatter.ts文件中，reservedSetOperations集合错误地包含了"EXCEPT"而不是PLSQL特有的"MINUS"操作符。这导致格式化引擎无法将MINUS识别为需要特殊处理的集合操作符。

解决方案

修复方案相对简单直接：将reservedSetOperations集合中的"EXCEPT"替换为"MINUS"。这一修改确保了格式化引擎能够正确识别PLSQL中的MINUS操作符，并给予它与其他集合操作符相同的格式化处理。

影响范围

该问题主要影响：

1. 使用PLSQL方言的用户
2. 包含MINUS集合操作的SQL查询
3. 所有使用15.4.9及之前版本的工具用户

修复版本

该问题已在15.4.10版本中得到修复。升级到此版本或更高版本的用户将不再遇到此格式化问题。

总结

这个案例展示了SQL方言差异在代码格式化工具中的重要性。作为开发者，在使用或开发这类工具时，必须充分了解目标SQL方言的特有语法和操作符。对于PLSQL用户来说，现在可以放心使用MINUS操作符而不用担心格式化问题了。这也提醒我们，在开发支持多方言的工具时，需要为每种方言维护准确的语法定义和操作符集合。

sql-formatter 项目地址: https://gitcode.com/gh_mirrors/sqlf/sql-formatter