SQL Formatter 项目中的TSQL关键字大小写格式化问题分析

在SQL代码格式化工具SQL Formatter中，TSQL语言的关键字大小写处理存在一个值得注意的技术细节。当用户设置keywordCase: "upper"参数时，格式化器不仅会将SQL关键字转换为大写，还会错误地将部分表名和列名也进行大写转换。

问题现象

在TSQL语法中，当遇到类似CREATE TABLE Catalog.Catalog这样的语句时，格式化器会将第一个"Catalog"（数据库架构名）错误识别为关键字并转换为大写，而第二个"Catalog"（表名）则保持原样。同样地，对于列名如"Floor"（既是一个普通列名，也是一个内置函数名），格式化器也会错误地将其转换为大写。

技术背景

SQL Formatter的核心功能之一是对SQL代码进行语法分析和格式化。在这个过程中，工具需要准确区分SQL关键字和用户定义的标识符（如表名、列名等）。对于TSQL这类SQL方言，识别工作尤为复杂，因为：

1. 许多内置函数名（如FLOOR）同时也是保留关键字
2. 数据库对象名称可能采用多部分命名方式（如schema.table.column）
3. 某些特殊函数可以不带括号使用（如CURRENT_TIME）

问题根源

经过分析，这个问题源于两个独立但相关的技术实现细节：

1. 对于table.column这类多部分标识符，格式化器当前仅对列名部分做了特殊处理，确保不被误认为关键字，但对表名部分没有同样处理
2. 对于函数名称的识别逻辑存在缺陷：所有不跟随括号的函数名都被视为关键字，而实际上只有少数特殊函数（如CURRENT_TIME）才符合这种用法

解决方案

项目维护者提出了以下改进方向：

1. 统一处理多部分标识符中的所有组成部分，确保它们不被误识别为关键字
2. 调整函数名称的识别逻辑，将大多数函数名视为普通标识符，仅对确实可以不带括号使用的特殊函数做例外处理

这种改进方案更符合实际使用场景，因为绝大多数情况下，函数名称后都会跟随括号，将其视为普通标识符能解决更多实际问题。

技术意义

这个问题的修复不仅提高了SQL代码格式化的准确性，也体现了SQL语法分析中的几个重要原则：

1. 上下文敏感性：同一词汇在不同语法位置可能有不同语义
2. 最小特权原则：对特殊情况的处理应尽可能局限，避免影响常规情况
3. 用户预期优先：格式化结果应符合大多数开发者的直觉和习惯

对于数据库开发人员而言，理解这些底层原理有助于编写更规范的SQL代码，也能更好地利用各种SQL工具提高工作效率。