Apache Superset 3.0.2与MySQL JSON字段交叉过滤异常问题求助

问题概述 #

使用Apache Superset 3.0.2对接含JSON字段的MySQL数据库，基于从JSON中提取的Agent（运营人员）字段制作饼图+词云仪表盘，初始展示正常，但触发Agent字段的交叉过滤时，Superset生成的查询包含无效条件：

WHERE `Agent` IS NULL
  OR `Agent` IN (NULL)
  AND (1 != 1)

该条件直接导致词云图无数据返回。

是否为Bug？ #

这大概率是Superset在处理通过函数动态生成的计算字段时的过滤逻辑Bug。当字段由JSON_EXTRACT+CAST这类组合函数生成时，Superset的过滤解析模块无法正确识别字段的非空特性，错误生成了包含NULL匹配和恒假条件的过滤语句。

解决方法 #

1. 简化JSON字段提取语法 #

改用MySQL 5.7+支持的->>原生JSON运算符替代嵌套函数，让生成的字段更贴近原生列，帮助Superset正确识别字段属性：

select 
  iridevoice_bi.speech.doc->>'$.callAttributes.teamId' as Team, 
  iridevoice_bi.speech.doc->>'$.callAttributes.operatorId' as Agent
from iridevoice_bi.speech 
where iridevoice_bi.speech.doc->>'$.callAttributes.operatorId' is not null 
  AND iridevoice_bi.speech.doc->>'$.callAttributes.teamId' is not null

2. 创建数据库视图封装解析逻辑 #

在MySQL中提前创建视图，将JSON字段解析为普通列，Superset直接基于视图创建数据集，绕过动态计算字段的过滤解析问题：

CREATE VIEW iridevoice_bi.speech_view AS
select 
  CAST(JSON_UNQUOTE(JSON_EXTRACT(doc, '$.callAttributes.teamId')) AS NCHAR) as Team, 
  CAST(JSON_UNQUOTE(JSON_EXTRACT(doc, '$.callAttributes.operatorId')) AS NCHAR) as Agent
from iridevoice_bi.speech 
where JSON_EXTRACT(doc, '$.callAttributes.operatorId') is not null 
  AND JSON_EXTRACT(doc, '$.callAttributes.teamId') is not null;

3. 升级Superset版本 #

该问题可能在后续版本中被修复，尝试升级到3.1.x及以上稳定版本，验证交叉过滤逻辑是否恢复正常。

4. 调整数据集字段配置 #

• 在Superset数据集的字段配置中，手动标记Agent字段为非空（原查询已过滤非空数据）；
• 确认Agent字段的类型被识别为字符串，避免类型识别错误导致过滤逻辑异常。

内容的提问来源于stack exchange，提问作者Marco Tinari