如何在Python SQL的IN运算符中传入元组？

你遇到的核心问题是：单元素元组（如(296,)）直接通过字符串拼接插入SQL的IN子句时，末尾多余的逗号会导致SQL语法错误——SQL要求单个值的格式是IN (296)，而非IN (296,)。

下面提供几种可行的解决方法：

1. 使用参数化查询（推荐，安全防注入） #

不要用str.format拼接SQL语句，而是利用pd.read_sql的params参数传递变量，pandas会自动处理元组格式，同时避免SQL注入风险：

query = '''
  SELECT timestamp as timestamp,
  id,
  users
  FROM rc 
  WHERE timestamp = %(timestamp)s AND id IN %(id_tuple)s
'''

df = pd.read_sql(query, con=sql.engine, params={"timestamp": timestamp, "id_tuple": id_tuple})

如果你的数据库适配问号占位符（如SQLite），也可以这样写：

query = '''
  SELECT timestamp as timestamp,
  id,
  users
  FROM rc 
  WHERE timestamp = ? AND id IN ?
'''

df = pd.read_sql(query, con=sql.engine, params=(timestamp, id_tuple))

2. 手动处理元组字符串格式 #

如果必须用字符串拼接，可根据元组长度调整输出格式：

# 处理id_tuple的字符串格式
if len(id_tuple) == 1:
    id_clause = f"({id_tuple[0]})"
else:
    id_clause = str(id_tuple)

query = '''
  SELECT timestamp as timestamp,
  id,
  users
  FROM rc 
  WHERE timestamp='{}' AND id IN {}
'''.format(timestamp, id_clause)

df = pd.read_sql(query, con=sql.engine)

3. 通过Join生成合法的IN子句 #

将元组元素转为字符串后用逗号拼接，再包裹括号，这种方法适用于任意长度的元组：

id_strs = [str(item) for item in id_tuple]
id_clause = f"({', '.join(id_strs)})"

query = '''
  SELECT timestamp as timestamp,
  id,
  users
  FROM rc 
  WHERE timestamp='{}' AND id IN {}
'''.format(timestamp, id_clause)

df = pd.read_sql(query, con=sql.engine)

注意事项 #

• 字符串拼接方式存在SQL注入风险，若timestamp或id_tuple包含用户输入内容，强烈建议使用参数化查询。

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