SuperSonic维度别名功能问题分析与解决方案

问题背景

SuperSonic作为一款开源的数据分析平台，其维度别名功能在实际使用中出现了两个关键问题：维度别名查询失效和维度别名无法编辑。这些问题影响了用户对维度数据的正常使用和管理。

问题现象

用户在使用过程中发现：

1. 在查询时，设置的维度别名无法生效，导致查询结果不符合预期
2. 已经设置的维度别名无法进行编辑操作，限制了数据维护的灵活性

技术分析

经过深入分析，发现问题的根本原因在于维度别名的存储结构和处理逻辑存在缺陷：

1. 存储结构不完整：维度别名保存到dim表的dim_value_maps字段时，JSON内容缺少必要的techName和bizName字段。而系统在处理维度别名时，DimValueAspect类的needSkipDimension方法和生成语义替换逻辑都需要判断这两个字段是否为空。

2. 数据处理流程缺陷：在查询解析阶段，LLM解析S2SQL时没有将别名转换为实际的维度值parsedS2SQL。虽然在执行阶段DimValueAspect会将SQL中的别名转换为正确的维度值，但最终执行的SQL并未被正确改写。

3. 依赖规则修正器：当前实现需要开启规则修正器，执行WhereCorrector中的getAliasAndBizNameToTechName方法才能正常工作，这种设计不够独立和健壮。

解决方案

针对上述问题，开发团队实施了以下改进措施：

1. 完善存储结构：确保维度别名保存时包含完整的字段信息，包括：

   • alias：别名数组
   • value：实际值
   • techName：技术名称
   • bizName：业务名称

   示例格式：

   [
     {
       "alias": ["管理者"],
       "value": "Y",
       "techName": "Y",
       "bizName": "是"
     },
     {
       "alias": ["不是管理者", "非管理者"],
       "value": "N",
       "techName": "N",
       "bizName": "否"
     }
   ]
   

2. 重构处理逻辑：

   • 将别名转换逻辑从规则修正器中独立出来
   • 在查询解析阶段就完成别名到实际值的转换
   • 确保执行阶段的SQL包含正确的改写

3. 增强编辑功能：

   • 修复维度别名编辑界面的功能
   • 确保编辑后的数据能正确保存并生效

实现效果

修复后，系统能够：

• 正确识别和使用维度别名进行查询
• 支持维度的编辑和保存操作
• 在查询解析和执行阶段都正确处理别名转换

最佳实践建议

1. 数据维护：在设置维度别名时，确保填写完整的字段信息，包括技术名称和业务名称。

2. 版本升级：对于从旧版本升级的用户，建议检查现有维度别名的数据结构，必要时进行数据迁移。

3. 功能验证：在使用维度别名功能时，可以通过以下步骤验证功能是否正常：

   • 设置维度别名并保存
   • 使用别名进行查询
   • 检查查询结果是否符合预期
   • 尝试编辑已设置的别名

总结

SuperSonic的维度别名功能经过此次修复，解决了查询失效和编辑不可用的问题，提升了系统的稳定性和易用性。开发团队通过完善数据结构、重构处理逻辑和增强编辑功能，为用户提供了更加可靠的数据分析体验。