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

在SQL代码格式化工具SQL Formatter的最新版本15.4.8中，用户报告了一个关于PostgreSQL方言下关键字大小写格式化的特定问题。本文将深入分析这一问题的技术背景、产生原因以及解决方案。

问题现象

当用户使用PostgreSQL方言配置SQL Formatter时，发现REPLACE关键字没有被正确转换为大写形式，尽管配置中明确设置了keywordCase: "upper"。具体表现为：

-- 输入
CREATE OR REPLACE function empty_function()...

-- 期望输出（保持REPLACE大写）
CREATE OR REPLACE function empty_function()...

-- 实际输出（REPLACE被转为小写）
CREATE OR replace function empty_function()...

技术背景

SQL Formatter是一个强大的代码格式化工具，它通过解析SQL语句的语法结构，然后根据用户配置重新生成格式化的代码。在PostgreSQL中，CREATE OR REPLACE FUNCTION是一个常见的语法结构，用于创建或替换函数。

问题根源

经过分析，问题的根本原因在于格式化器没有正确识别OR REPLACE作为CREATE FUNCTION语句的一部分。在语法解析阶段，工具未能将这一组合视为一个整体结构，导致后续的大小写转换逻辑应用不一致。

配置优化建议

在解决此问题的过程中，还发现了一些关于配置使用的优化点：

1. dialect与language参数：当同时配置language和dialect参数时，dialect参数实际上不会生效。dialect参数主要用于编程接口调用，在配置文件中使用可能在未来版本中导致问题。

2. identifierCase参数：这是一个实验性功能，使用时可能导致大量关键字被转换为小写。除非需要统一代码风格为全大写或全小写，否则不建议常规使用。

解决方案

开发团队迅速响应，通过修复语法解析逻辑，确保OR REPLACE被正确识别为CREATE FUNCTION语句的组成部分。这样格式化器就能根据keywordCase配置正确处理这些关键字的大小写转换。

最佳实践

对于PostgreSQL用户，建议：

1. 仅使用language: "postgresql"配置，避免冗余的dialect设置
2. 谨慎使用实验性功能，如identifierCase
3. 定期更新工具版本以获取最新的语法支持

这一问题的快速解决体现了SQL Formatter项目对PostgreSQL方言支持的持续改进，也展示了开源社区响应问题的效率。