Superset1.1.0版本SQL Lab缺失parameters按钮配置未生效问题咨询

一、配置未生效排查 #

• 优先级校验：Superset 会优先读取superset_config.py的自定义配置，你仅需要在该文件中添加ENABLE_TEMPLATE_PROCESSING = True即可，默认config.py的同参数修改会被覆盖，无需重复修改。
• 生效方式校验：superset db upgrade、superset init仅用于更新数据库元数据和初始化权限，不会重载运行中的服务配置，修改配置后必须重启完整的Superset服务（包括Web进程、Celery worker进程）。
• 生效状态校验：你可以执行superset shell进入交互终端，运行以下代码验证配置状态：

  from superset.config import ENABLE_TEMPLATE_PROCESSING
  print(ENABLE_TEMPLATE_PROCESSING)
  

  输出为True代表配置生效，输出为False则配置未正确加载。

二、SQL Lab参数入口说明 #

Superset 1.1.0版本没有独立的parameters显性按钮，参数配置入口如下：

• 打开SQL Lab查询编辑页，点击编辑区右上角「保存」按钮旁的下拉箭头
• 选择「查询属性（Query properties）」
• 在弹出窗口的「模板参数（Template Parameters）」栏填写符合JSON规范的参数，例如{"city": "北京", "sale_start": "2024-01-01"}
• 查询语句中直接用{{参数名}}格式调用即可，此处配置的参数优先级高于数据集层面配置的模板参数。

三、参数调用报错排查 #

• 格式校验：确认数据集或查询属性中填写的模板参数是合法JSON，没有多余尾逗号、引号不匹配、中英文符号混用的问题。
• 大小写校验：参数名调用严格区分大小写，例如配置的参数是{"orderId": 1001}，调用时写{{orderid}}会直接报错。
• 权限校验：确认当前登录账号拥有can_use_template_processing权限，普通用户需要在「安全-角色管理」中给对应用户角色添加该权限，管理员账号默认持有。
• 版本兼容校验：1.1.0版本不支持嵌套结构的模板参数，不要配置{"user": {"id": 123, "name": "张三"}}这类多层嵌套参数，调用时会无法识别。

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