SQLAlchemy中pd.read_sql_query数值加单引号返回错误怎么解决？

你遇到的两类错误核心都是SQL查询中值的类型和字段类型不匹配，导致比较逻辑异常：

• 给数值类型的release_year、gross加单引号：数据库会把这些值识别为字符串，按字典序而非数值大小比较。例如字符串比较时'700000' > '2000000'会返回True（首字符'7'的ASCII码大于'2'），所以会筛选出大量低票房的错误结果。
• 不加单引号直接写数值对比：如果你的release_year字段在数据库中实际是字符串类型存储，直接和数值比较会触发数据库的隐式类型转换，转换规则不受控制，就会出现不符合年份条件的结果。

不要手动拼接SQL语句、手动给值加/减引号，直接使用pd.read_sql_query自带的参数化查询功能，让数据库驱动自动处理类型匹配，既可以避免类型不匹配的问题，还能防范SQL注入风险，是工业界通用的最佳实践。

示例代码如下（根据你使用的数据库类型调整参数占位符即可）：

# 定义SQL语句，用占位符代替实际值，不用加任何引号
sql = """
SELECT title, release_year, gross
FROM films
WHERE (release_year >= %s AND release_year < %s)
AND (language = %s OR language = %s)
AND gross > %s
"""
# 按占位符顺序传入实际参数，数值直接传数值类型，字符串直接传字符串类型
params = (1990, 2000, 'French', 'Spanish', 2000000)
# 调用read_sql_query时传入params参数
df = pd.read_sql_query(sql, engine, params=params)

不同数据库的参数占位符有差异：

• PostgreSQL、MySQL：用%s作为占位符
• SQLite：用?作为占位符
• Oracle：用:1、:2这类序号作为占位符

如果需要确认字段类型，可以先查询表结构：

-- MySQL 查看表结构
DESCRIBE films;

-- PostgreSQL/SQLite 查看字段类型
SELECT typeof(release_year), typeof(gross) FROM films LIMIT 1;

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