如何将ID列表作为参数传入Doris SQL查询？

当前Doris LTS版本没有原生支持直接将ID列表作为单个参数绑定到IN子句的官方推荐方法，以下是几种经过实践验证的标准替代方案：

1. 拆分多参数绑定 #

将ID列表拆分为多个独立的参数占位符，直接在IN子句中使用：

SELECT * FROM my_table WHERE id IN (@p1, @p2, @p3);

• 优势：完全遵循参数化查询规范，彻底避免SQL注入风险，查询性能稳定。
• 实践要点：如果ID数量不固定，可在客户端代码中根据列表长度动态生成对应数量的占位符（如@p1到@pn），再批量绑定参数值，主流编程语言的数据库驱动均支持这种动态参数绑定逻辑。

2. 字符串拆分+数组函数结合参数绑定 #

将ID列表拼接为逗号分隔的字符串参数，借助Doris的字符串/数组函数实现匹配：

方案A（使用split+array_contains） #

SELECT * FROM my_table 
WHERE array_contains(split(@id_list, ','), CAST(id AS STRING));

方案B（使用str_to_array+UNNEST，部分新版本支持） #

SELECT * FROM my_table 
WHERE id IN (SELECT CAST(element AS INT) FROM UNNEST(str_to_array(@id_list, ',')) AS t(element));

• 优势：只需传递单个参数，无需动态生成占位符，代码实现更简洁。
• 注意事项：需确保传入的字符串参数格式合法（仅包含数字和逗号）；当ID数量超过万级时，字符串拆分和类型转换会带来一定性能损耗，适合中小规模ID列表场景。

3. 表值函数（TVF）+ JOIN替代IN子句 #

利用Doris的VALUES表值函数构造临时ID数据集，通过JOIN操作替代IN子句：

SELECT t.* FROM my_table t
JOIN (VALUES (@p1), (@p2), (@p3)) AS ids(id) ON t.id = ids.id;

• 优势：参数化安全，执行计划通常比字符串拆分更高效，尤其适合ID数量较多的场景。
• 实践要点：同样需要根据ID列表长度动态生成VALUES中的参数占位符，与拆分多参数的逻辑一致，但JOIN的方式在大数据量下性能更优。

超大ID列表场景补充方案 #

如果业务中需要处理十万级以上的超大ID列表，可将ID写入CSV文件，通过Doris的外部表映射该文件，再与目标表进行JOIN查询，这种方式能避免参数数量限制，且性能更稳定。

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