FreeSql中UnionAll分页查询的注意事项

在使用FreeSql进行复杂查询时，UnionAll操作是一个常见的需求，特别是在需要合并多个查询结果集的情况下。然而，当UnionAll与分页查询结合使用时，开发者可能会遇到一些意料之外的问题。

问题现象

在FreeSql 3.2.815.0版本中，当开发者尝试在UnionAll操作中包含分页查询时，生成的SQL语句会出现异常。具体表现为：

1. 第一页查询时，SQL语句中会包含TOP 10限制
2. 第二页查询时，SQL语句中会包含TOP 100限制
3. 分页逻辑未能正确应用于整个联合查询结果

问题分析

问题的根源在于UnionAll操作内部已经包含了分页逻辑。在FreeSql的实现中，UnionAll操作会将两个查询结果合并为一个结果集，而如果在UnionAll内部的查询中已经使用了Page方法，就会导致分页逻辑的混乱。

正确的做法应该是将分页逻辑应用于整个UnionAll查询的结果集，而不是在UnionAll内部的查询中使用分页。

解决方案

要解决这个问题，开发者需要：

1. 移除UnionAll内部查询中的Page方法调用
2. 将分页逻辑统一放在UnionAll查询之后

修改后的代码结构应该是这样的：

var query = _reportRepository.FreeSql.Select<RealtimeMonitorEntity>()
    .FromQuery(realTimeAiEventValueSelect, callRecordSelect)
    // 其他查询条件
    .WithTempQuery((a,b,c) => new CallRecordDetailModel { /* 字段映射 */ })
    .UnionAll(_reportRepository.FreeSql.Select<CallRecordEntity>()
        .Where(a => a.EventId == 0 && a.RealtimeMonitorId == idmapper.Id)
        // 其他查询条件
        .WithTempQuery(a => new CallRecordDetailModel { /* 字段映射 */ }))
    .OrderByDescending(a => a.CallBeginTime)
    .Page(pageIndex, pageSize);

最佳实践

在使用FreeSql进行复杂查询时，特别是涉及UnionAll操作时，建议遵循以下原则：

1. 保持查询逻辑的清晰性，将分页操作放在最外层
2. 避免在子查询中使用分页，除非有特殊需求
3. 对于复杂的联合查询，可以先测试生成的SQL语句是否符合预期
4. 使用WithTempQuery方法时，确保所有联合查询返回的字段类型和顺序一致

总结

FreeSql作为一款强大的ORM框架，提供了丰富的查询功能。在使用UnionAll等高级查询操作时，开发者需要理解其内部工作原理，特别是分页逻辑的应用范围。通过合理组织查询结构，可以避免类似问题，构建出高效、正确的查询语句。

记住，在大多数情况下，分页操作应该应用于最终结果集，而不是中间查询过程。这一原则不仅适用于FreeSql，也适用于其他ORM框架和数据库查询场景。