如何在psycopg2中使用字典内的元组实现命名参数及WHERE IN查询

看起来你遇到的核心问题是：传递给WHERE IN子句的元组被psycopg2错误地转换成了一个单一的字符串值（从你提供的mogrify结果能看到，所有site_id被包在同一个单引号里），导致数据库无法正确匹配多个site_id。下面是两种可靠的解决方案，都是psycopg2官方推荐的做法，完全规避手动拼接字符串的SQL注入风险。

方法1：直接使用IN %(param)s传递元组参数 #

psycopg2原生支持将字典中的元组参数自动扩展为IN子句需要的格式，你只需要在SQL语句中直接引用命名参数即可：

import psycopg2

# 你的site_id元组
target_sites = ('TSE-000027', 'TSE-000032', 'TSE-000030', ...)

# 构建参数字典，元组直接作为值
query_params = {
    "site_ids": target_sites
}

# 编写SQL语句，注意IN后面直接跟%(site_ids)s
sql_query = """
SELECT site_id, site_name, date, time, * 
FROM "SiteInfoSchema"."Compressor" 
WHERE site_id IN %(site_ids)s
"""

# 连接数据库并执行
with psycopg2.connect("dbname=your_db user=your_user password=your_pw") as conn:
    with conn.cursor() as cur:
        # 验证生成的SQL（此时mogrify会输出正确的多值格式）
        print(cur.mogrify(sql_query, query_params).decode('utf-8'))
        # 执行查询
        cur.execute(sql_query, query_params)
        results = cur.fetchall()

执行后，mogrify生成的SQL会变成：

WHERE site_id IN ('TSE-000027', 'TSE-000032', 'TSE-000030', ...)

完全符合预期，数据库能正确识别每个site_id作为独立的匹配值。

方法2：使用ANY(%(param)s)操作符 #

如果你觉得IN子句的写法不够灵活，也可以用PostgreSQL的ANY操作符，psycopg2会自动把元组转换成PostgreSQL数组格式：

sql_query = """
SELECT site_id, site_name, date, time, * 
FROM "SiteInfoSchema"."Compressor" 
WHERE site_id = ANY(%(site_ids)s)
"""

# 参数字典和之前完全一致
query_params = {"site_ids": target_sites}

# 执行逻辑和方法1相同
with psycopg2.connect(...) as conn:
    with conn.cursor() as cur:
        cur.execute(sql_query, query_params)
        results = cur.fetchall()

这种写法的效果和方法1完全一致，适合习惯用数组操作的场景。

需要避免的错误做法 #

千万不要手动把元组拼接成逗号分隔的字符串（比如','.join(target_sites)）再传递给参数，这不仅会引发你现在遇到的“单值包裹”问题，还会带来严重的SQL注入风险。psycopg2的参数绑定机制已经帮你处理了所有值的转义和格式转换，完全不需要手动干预。

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