Apache Superset中booking_xml表无法加载列及查询报错求助

问题现象 #

• 添加booking_xml表后无法加载任何列，其余数据表均正常加载
• 点击该表的「探索」按钮时触发「Empty query?」错误，完整报错栈：

Empty query?
Traceback (most recent call last):
  File "/home/superset/superset_venv/lib/python3.8/site-packages/superset/viz.py", line 473, in get_df_payload
    df = self.get_df(query_obj)
  File "/home/superset/superset_venv/lib/python3.8/site-packages/superset/viz.py", line 251, in get_df
    self.results = self.datasource.query(query_obj)
  File "/home/superset/superset_venv/lib/python3.8/site-packages/superset/connectors/sqla/models.py", line 1139, in query
    query_str_ext = self.get_query_str_extended(query_obj)
  File "/home/superset/superset_venv/lib/python3.8/site-packages/superset/connectors/sqla/models.py", line 656, in get_query_str_extended
    sqlaq = self.get_sqla_query(**query_obj)
  File "/home/superset/superset_venv/lib/python3.8/site-packages/superset/connectors/sqla/models.py", line 801, in get_sqla_query
    raise Exception(_("Empty query?"))
Exception: Empty query?
ERROR:superset.viz:Empty query?

• 通过SQL Lab可正常查询该表数据
• 对比URL参数发现：数据集列表页跳转探索的URL缺少granularity_sqla和metrics参数，直接访问/explore_json/返回400 Bad Request
• 运行环境：Superset 0.37.1，Python 3.8

原因分析 #

Superset 0.37.1的探索模块依赖granularity_sqla（时间粒度字段）和metrics（度量字段）生成有效查询。booking_xml表触发问题的核心原因是：

• 表中没有符合Superset自动识别规则的时间字段（比如字段名不含date/time/timestamp关键词，或字段类型不被判定为时间类型）
• 表内所有字段均为非数值类型（如全是字符串、XML类型），无法自动生成默认度量

这两个条件同时满足时，Superset生成的探索请求会缺失关键参数，导致查询为空触发报错。

解决方案 #

1. 手动配置数据集的时间字段与度量（推荐） #

1. 在数据集列表找到booking_xml表，点击「编辑」进入配置页面
2. 设置时间字段：
   • 找到「Time Column」选项，手动选择一个字段（如果没有时间字段，可临时选择任意字符串字段，或通过「Add Calculated Column」创建一个固定时间字段作为替代）
3. 添加度量：
   • 进入「Metrics」区域，点击「Add Metric」
   • 填写度量名称（如记录数），SQL表达式输入COUNT(*)，聚合类型选择COUNT
4. 保存配置后，重新进入探索视图即可正常使用

2. 手动补充URL参数临时验证 #

若需快速验证问题，可在探索页面URL中手动补充form_data参数：
原URL示例：/explore/?datasource_type=table&datasource_id=123
修改为：
/explore/?datasource_type=table&datasource_id=123&form_data={"granularity_sqla":"your_time_field","metrics":["COUNT(*)"]}

注意：替换your_time_field为表中实际字段名；若没有时间字段，可将granularity_sqla设为null（部分版本可能不兼容，优先用方案1）

3. 检查表结构兼容性 #

如果表字段完全无法加载，需排查数据库驱动对特殊字段类型的支持：

• 若booking_xml包含XML类型字段，部分数据库驱动可能无法将其识别为Superset兼容类型，可在数据库层面创建视图，将XML字段解析为普通字符串/结构化字段后，再将视图添加到Superset
• 确认数据库用户对booking_xml表有足够的权限（如SELECT权限），权限不足也可能导致字段加载失败

内容的提问来源于stack exchange，提问作者Rahul Hindocha