官方文档

填报分页

大数据订正:数据集分页、每页行数、仅提交修改行、稳定 ORDER BY 与翻页守卫。

填报分页面向大数据订正:填报预览按页从数据集加载行,在线修改后按配置提交(推荐只提交改过的行),避免一次拉全表导致卡顿。

相关:填报概述 · 填报示例

1. 何时开启

  • 目标表或查询结果达到数千~十万行,需要在线改少量字段。
  • 需要稳定翻页浏览并分批提交。

未开启分页时,仍可能一次加载大量行(受系统预览行数上限约束)。大数据订正请务必开启「数据集分页」。

2. 制作配置

① SQL 排序
稳定 ORDER BY
② 预览设置
分页 + 提交范围
③ 填报设置
仅更新 + 主键
④ 翻页提交
改完再翻页

2.1 数据集 SQL

SELECT id, name, age
FROM `user`
ORDER BY id

必须带稳定 ORDER BY(如主键),否则翻页顺序可能错乱、漏改或重复。

2.2 模版预览设置(填报预览)

路径:设计器 设置 → 模版预览设置 → 填报预览

说明建议
显示工具栏是否显示填报工具栏开启
数据集分页按页从库加载大数据务必开启
每页行数单页加载行数100~200
提交范围DIRTY_ONLY / PAGE_ALL仅提交修改过的行

2.3 填报设置(订正场景)

  • 写入策略:仅更新(避免误插入)。
  • 至少勾选一列主键;未配主键时设计器会拦截保存。

3. 使用与提交方式

  1. 打开 填报预览。开启分页后,工具栏左侧为分页(首页 / 上一页 / 页码 / 下一页 / 末页),右侧为提交、重置、打印、导出、Excel 导入。
  2. 在当前页修改单元格;改过的行会标记为待提交(仅修改行模式)。
  3. 点击 提交
    • 仅提交修改过的行:只写脏行,减少整页重写(推荐)。
    • 提交当前页全部行:当前页每一行都按策略写库。
  4. 若有未保存修改就翻页,系统会提示先提交或放弃修改。
  5. 单次改动单元格过多时,可能弹出确认,避免误提交超大变更。

分页预览 ≠ 填报分页。 「预览 → 分页预览」是普通查询分页工具栏(打印/导出等),没有提交。数据订正请使用 填报预览

4. 与 Excel 批改分工

场景建议
改几条~几百条填报分页在线改 + 仅修改行提交
同结构大批量导出 → Excel → 导入 → 提交

5. 常见问题

Q:翻页后数据顺序乱了?
A:给数据集 SQL 加上稳定 ORDER BY(如主键)。

Q:工具栏没有分页按钮?
A:确认已开启「数据集分页」并保存报表;打开的是填报预览

Q:提交了但只改了一页?
A:分页模式下每次提交针对当前页(及当前页脏行)。其他页需翻页后再改、再提交。