SQL Formatter中TSQL数据类型大小写格式化问题解析

SQL Formatter中TSQL数据类型大小写格式化问题解析

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

在SQL代码格式化工具SQL Formatter的最新版本15.4.7中，发现了一个关于TSQL(Transact-SQL)数据类型大小写格式化的特殊案例。当用户同时配置functionCase: "upper"和dataTypeCase: "lower"时，CHAR数据类型会出现不符合预期的大写输出。

问题现象

开发人员在使用prettier-plugin-sql插件格式化TSQL代码时，遇到以下不一致行为：

输入SQL：

CREATE TABLE Test123(
    Col1 Nvarchar(100),
    Col2 Char(100)
)

期望输出（所有数据类型小写）：

CREATE TABLE Test123(
    Col1 nvarchar(100),
    Col2 char(100)
)

实际输出（CHAR保持大写）：

CREATE TABLE Test123(
    Col1 nvarchar(100),
    Col2 CHAR(100)
)

技术分析

这个问题源于SQL Formatter内部对TSQL关键字分类的逻辑设计。在Transact-SQL中，CHAR既可以被视为数据类型，也可以被视为函数（当带参数使用时）。SQL Formatter原本应该将其统一归类处理，但实际上：

1. CHAR被同时包含在了函数列表和数据类型列表中
2. 当配置functionCase: "upper"时，函数列表中的关键字会被强制转为大写
3. 数据类型的大小写转换则遵循dataTypeCase: "lower"配置
4. 由于分类冲突，CHAR优先按照函数处理，导致保持大写

解决方案

项目维护者已通过提交修复了此问题。核心解决思路是：

1. 明确CHAR在TSQL中的主要角色是数据类型
2. 将其从函数列表中移除，确保只受数据类型大小写配置影响
3. 保持CHAR与其他数据类型（如NVARCHAR）的大小写处理一致性

最佳实践建议

对于使用SQL Formatter的开发团队，建议：

1. 定期更新格式化工具版本，以获取最新的修复和改进
2. 在团队中统一SQL格式化配置，特别是大小写规则
3. 对于TSQL开发，注意数据类型和函数的关键字重叠情况
4. 在遇到格式化异常时，检查是否为已知问题，或向项目提交issue

此修复确保了TSQL代码格式化的一致性，使开发人员能够更可靠地使用自动化工具维护代码风格规范。

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