SQLAlchemy如何实现同时查询列值与对应列的COUNT统计值

逻辑对齐说明 #

原生SQL查询SELECT col1, COUNT(col1) FROM "table"的核心逻辑是按col1维度分组，同时返回每个分组的列值、对应分组的计数结果。
日常用到的session.query(MyTable.col1).count()写法，本质是生成返回单值的全表计数SQL，只会输出总计数结果，完全丢失列值信息，无法满足“列值+计数”的组合返回需求。

具体实现 #

• 前置依赖：从SQLAlchemy导入内置聚合函数
  from sqlalchemy import func
• 基础表查询的等价实现：

  session.query(
      MyTable.col1,
      func.count(MyTable.col1)
  ).group_by(MyTable.col1).all()
  

  返回结果为元组列表，每个元组结构为(col1具体值, 对应值的计数)，和原生SQL的返回结构完全匹配。
• 适配User模型查询的改写：
  针对原有逻辑db.query(models.User.places).filter(models.User.id == 10).all()，调整为同时返回places字段值与对应计数的写法：

  db.query(
      models.User.places,
      func.count(models.User.places)
  ).filter(models.User.id == 10).group_by(models.User.places).all()
  

常见误区提醒 #

• 不要直接在列值查询链路末尾拼接.count()方法，该方法会覆盖原有查询逻辑，生成仅返回总计数的单值SQL，无法保留列值结果。
• 所有需要同时返回维度列与聚合统计值的场景，都遵循统一编写逻辑：查询参数中同时传入维度列、对应的聚合表达式，最后追加维度列的group_by子句，和原生SQL的编写规则保持一致。

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