Cube模板参数配置报错，Superset中如何实现用户可设testlet_id？

问题背景 #

作为Cube与Apache Superset的新手，已定义如下items cube：

cubes:
   - name: items
sql: >
  SELECT DISTINCT
    ...
  FROM
    ...
  WHERE
      lt.package_org_id = '{{ testlet_id }}'          

joins: []

dimensions:
  <various dimensions specified> 

measures:
  - name: count
    type: count

需求是在Superset创建图表时允许用户自定义testlet_id参数，但选择该cube时触发PostgreSQL错误：

postgresql error: Arrow error: Compute error: Error: invalid input syntax for type bigint: "null"

已在superset_config.py启用模板处理特性：

SECRET_KEY = <key>
FEATURE_FLAGS = {'ENABLE_TEMPLATE_PROCESSING': True}

咨询：当前模板参数写法是否正确？如何配置才能实现用户自定义testlet_id的需求？

解决方案 #

1. 当前写法的问题 #

你用的{{ testlet_id }}语法本身是Jinja2模板，但核心问题是：当Superset未传入参数时，模板会渲染成字符串"null"，而lt.package_org_id是bigint类型，字符串"null"无法转换为整数，触发类型错误。

2. 正确配置步骤 #

步骤1：修改Cube的SQL模板，处理空值与类型转换

在Cube的SQL中添加条件判断和类型过滤，确保参数未传入时不会生成无效SQL：

cubes:
   - name: items
sql: >
  SELECT DISTINCT
    ...
  FROM
    ...
  {% if testlet_id is not none %}
  WHERE
      lt.package_org_id = {{ testlet_id | int }}
  {% endif %}

• 用{% if %}判断参数是否存在，避免无参数时生成多余的WHERE子句
• 用| int过滤器强制将参数转为整数，匹配bigint字段类型

步骤2：在Superset中配置参数

当在Superset创建图表选择该Cube时：

• 进入图表创建界面的模板参数区域（启用ENABLE_TEMPLATE_PROCESSING后会显示）
• 添加参数testlet_id，设置类型为整数，可配置默认值（比如0或常用业务ID）

步骤3：扩展支持多ID场景（可选）

如果需要允许用户输入多个testlet_id，可调整为IN查询：

sql: >
  SELECT DISTINCT
    ...
  FROM
    ...
  {% if testlet_ids %}
  WHERE
      lt.package_org_id IN ({{ testlet_ids | join(',') }})
  {% endif %}

此时在Superset中参数testlet_ids可接受逗号分隔的整数列表。

3. 额外注意事项 #

• Cube本身支持Jinja2模板，无需额外配置，只需确保语法符合Jinja2规范
• 如果参数是字符串类型，需用单引号包裹（比如lt.package_name = '{{ testlet_name }}'），但你的场景是bigint，直接用整数即可
• 可先在Cube的SQL Runner中传入参数验证SQL生成结果，再同步到Superset测试

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