SQL 后台分页适用于数据库查询数据集。启用后,系统会通过分页 SQL 每次查询当前页数据,并根据配置决定是否查询总记录数。
配置项说明
| 配置项 | 说明 |
|---|---|
| 每页记录数 | 每页需要展示的数据条数。例如设置为 10,则每次预览或翻页只查询 10 条数据。 |
| 数据行数汇总 | 勾选后,系统会查询当前分页数据集的总记录数,并据此计算总页数。 |
使用步骤
- 在数据集配置中创建数据库查询数据集,并完成 SQL 查询配置。
- 在报表中绑定该数据集字段,完成报表模板设计。
- 打开“引擎属性”。
- 勾选“启用后台分页”。
- 设置“每页记录数”。
- 根据需要勾选“数据行数汇总”。
- 保存后进行预览。
例如,现有一张报表启用了 SQL 后台分页,每页记录数为 10,并勾选“数据行数汇总”。预览时,系统首次只查询第 1 页的 10 条数据;点击下一页时,再查询第 2 页的 10 条数据。

注意事项
- SQL 后台分页主要用于普通数据库查询数据集。
- 启用后台分页后,报表每次只处理当前页数据。
- 如果报表中存在依赖全量数据的统计、排序或跨页汇总,需要确认这些逻辑在分页后仍符合业务预期。
- 勾选“数据行数汇总”后,系统会额外查询总记录数,用于计算和展示总页数。
