Apache Superset虚拟数据集Jinja模板SQL过滤语法错误排查

错误原因 #

filter_values('region')函数返回的是数组类型，直接拼接会把数组格式（如['nd']）带入SQL，导致生成'%['nd']%'这种存在语法错误的字符串——SQL解析时会把嵌套的单引号和方括号识别为非法语法。

解决方案 #

根据你使用的数据库类型，选择对应的处理方式，核心是把filter_values返回的数组转换为单个字符串值：

1. 针对PostgreSQL（推荐，兼容多筛选值场景）

使用array_to_string将数组转为字符串，配合coalesce处理未输入筛选值的情况：

select * from portna
where region ilike '%' || coalesce(array_to_string({{ filter_values('region') }}, ''), '') || '%'

• array_to_string({{ filter_values('region') }}, '')：把筛选数组的所有值拼接成一个字符串（如果选多个值，会连在一起匹配）
• coalesce(..., '')：如果没有输入筛选值，默认空字符串，避免SQL报错

2. 仅单个筛选值场景（简化写法）

如果确定每次只输入一个筛选值，可以直接取数组的第一个元素：

select * from portna
where region ilike '%' || {{ filter_values('region')[0] or "''" }} || '%'

• {{ filter_values('region')[0] or "''" }}：取第一个筛选值，若未输入则用空字符串

注意事项

• 字符串拼接符：不同数据库拼接符不同，PostgreSQL用||，MySQL用concat函数，比如MySQL写法：

  select * from portna
  where region ilike concat('%', coalesce({{ filter_values('region')[0] }}, ''), '%')
  

• ilike实现不区分大小写匹配，若需要区分大小写，换成like即可。

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