Amazon Redshift参数使用异常：数据预处理正常但数据集导入失败

问题背景 #

在Amazon Redshift中使用参数实现仪表板直接传参，查询在Data Prep（数据预处理）阶段能正常运行并预览结果，但保存数据集时触发导入错误。

参数信息 #

• DateFrom：日期类型，默认值2024-01-01
• DateTo：日期类型，默认值2025-01-01

原查询语句 #

SELECT org_uid, COUNT(DISTINCT item_uid) as active_items 
FROM organizations_activity 
WHERE item_updated_at BETWEEN <<$DateFrom>> AND <<$DateTo>>
GROUP BY org_uid

保存时的错误详情 #

Refresh error details

Error type: 0 Learn more

Error details: ERROR: syntax error at or near "$" Position: 411

尝试修改后的报错 #

将参数格式改为:DateFrom和:DateTo后，Data Prep阶段直接报语法错误：

sourceErrorMessage: 
ERROR: syntax error at or near ":" Position: 63
sourceErrorState:   
42601
sourceException:    
org.postgresql.util.PSQLException
sourceType: 
REDSHIFT

解决方案 #

Redshift原生不支持<<$参数名>>或:参数名这类BI工具专属的参数语法——这类语法是工具在Data Prep阶段自行解析替换的，但保存数据集时，工具可能直接把未解析的原语句发送给Redshift，导致语法报错。以下是几种可行的解决方法：

1. 使用Redshift存储过程实现参数化 #

创建带参数的存储过程，通过调用存储过程来执行查询：

CREATE OR REPLACE PROCEDURE get_active_items(p_date_from DATE, p_date_to DATE)
LANGUAGE plpgsql
AS $$
BEGIN
    EXECUTE 'SELECT org_uid, COUNT(DISTINCT item_uid) as active_items 
             FROM organizations_activity 
             WHERE item_updated_at BETWEEN $1 AND $2
             GROUP BY org_uid'
    USING p_date_from, p_date_to;
END;
$$;

之后在Data Prep中调用该存储过程并传入对应参数即可。

2. 适配BI工具的Redshift参数语法 #

检查你所用BI工具（如Amazon QuickSight）的参数配置规则，确认Redshift数据源的参数化查询格式。以QuickSight为例，需用?作为占位符，再在工具层面绑定参数：
修改查询语句为：

SELECT org_uid, COUNT(DISTINCT item_uid) as active_items 
FROM organizations_activity 
WHERE item_updated_at BETWEEN ? AND ?
GROUP BY org_uid

然后在工具的参数配置中，将第一个?绑定到DateFrom参数，第二个?绑定到DateTo参数。

3. 字符串拼接临时方案（不推荐） #

如果工具不支持占位符，可通过拼接参数为带单引号的日期字符串让Redshift识别，但此方法存在SQL注入风险，仅作临时应急：

SELECT org_uid, COUNT(DISTINCT item_uid) as active_items 
FROM organizations_activity 
WHERE item_updated_at BETWEEN '''' || <<$DateFrom>> || '''' AND '''' || <<$DateTo>> || ''''
GROUP BY org_uid

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