Supersonic项目中Doris数据库大小写敏感问题的技术解析与解决方案

背景概述

在Supersonic项目使用过程中，开发团队发现当连接Doris数据库时，如果数据库中的库表名采用大写命名，在指标探索功能中会出现无法正确识别的问题。这是由于Doris数据库本身对库表名大小写敏感的特性与应用程序处理方式不匹配导致的典型兼容性问题。

问题本质分析

Doris作为一款MPP分析型数据库，其元数据存储机制严格区分大小写。这意味着：

1. 创建名为"ANALYTICS_DB"的数据库与"analytics_db"将被视为两个不同的数据库对象
2. 表名"USER_PROFILE"和"user_profile"也会被识别为不同的表

而在Supersonic的指标探索模块中，系统默认将用户输入的库表名转换为小写形式进行查询，这种自动转换行为与Doris的严格大小写敏感机制产生了冲突，导致系统无法定位到实际存在的大写命名数据库对象。

技术解决方案

针对该问题，开发团队提出了多层次的解决方案：

1. 元数据查询优化

修改数据库连接层的元数据查询逻辑，确保：

• 保持原始大小写形式传递库表名
• 在生成SQL查询时使用正确的引号包裹标识符
• 对Doris特有的元数据表information_schema进行适配性查询

2. 配置层增强

增加数据库连接配置项：

# 是否保持标识符大小写
datasource.doris.case-sensitive=true
# 标识符引用符号
datasource.doris.identifier-quote=`

3. 用户界面提示

在指标探索界面添加明显的提示信息：

• 当检测到Doris数据源时，提示用户注意大小写匹配
• 在表选择器中显示实际存在的大小写形式

实现细节

核心修改集中在数据库驱动处理层，主要涉及：

1. 重写JDBC元数据获取逻辑，绕过默认的大小写转换
2. 实现DatabaseMetaData接口的定制化版本
3. 增加对Doris特定SQL方言的支持

关键代码片段示例：

// 保持原始大小写的表名处理
String tableName = meta.getTableName();
if(isDorisDatabase() && isCaseSensitive()){
    tableName = "`" + tableName + "`";
}

最佳实践建议

对于使用Supersonic连接Doris数据库的用户，建议：

1. 统一采用小写命名规范创建数据库对象
2. 如果必须使用大写命名，确保在Supersonic中完全匹配大小写
3. 升级到包含此修复的版本（建议0.3.0+）

总结

该问题的解决不仅修复了大小写敏感的兼容性问题，还为Supersonic项目建立了更健壮的数据库适配层框架，为后续支持更多类型的数据库打下了良好基础。这体现了开源项目通过社区协作不断完善技术细节的典型过程。