如何修复SQLAlchemy窗口函数生成SQL时过滤条件出现占位符?的问题

你观察到的?占位符是SQLAlchemy参数化查询的默认行为，不属于代码bug：SQLAlchemy会自动把查询中的字面量值转为参数占位符，交由数据库驱动完成参数绑定，既可以避免SQL注入风险，也能提升重复查询的执行效率。你原本的代码执行逻辑完全符合需求，实际运行时会自动把1绑定到占位符位置，最终查询结果就是每个portfolio_id分组内的最高版本记录。

分两种场景选择对应处理方式：

场景1：仅调试需要查看完整带参数的SQL #

不需要修改业务代码，打印查询语句时使用compile方法指定参数字面量展开即可，示例代码：

# 打印完整SQL语句
print(current_config.compile(compile_kwargs={"literal_binds": True}))

场景2：需要生成的SQL中直接包含字面量1，无占位符 #

如果有导出静态SQL、特殊数据库兼容等需求，可以用SQLAlchemy提供的literal函数显式声明字面量，修改过滤条件即可：

from sqlalchemy import literal

# 原有子查询逻辑不变
subquery = session.query(
        MyTable,
        func.row_number().over(
          partition_by=MyTable.portfolio_id,
          order_by=MyTable.version.desc()).label("row_number")
      ).subquery()

# 过滤条件用literal包裹1
current_config = session.query(subquery).filter(subquery.c.row_number <= literal(1))

修改后编译生成的SQL中WHERE子句就会直接显示WHERE anon_1.row_number <= 1。

注意：参数化查询是ORM框架的安全最佳实践，没有特殊需求不建议强制使用字面量，原代码的执行结果是完全正确的，无需修改。

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