JQuick-SQL LIMIT 分页：限制行数与偏移查询

Meta 描述：掌握 jquick-sql 的 LIMIT n 与 LIMIT offset, n 语法，结合 ORDER BY 实现稳定分页，并使用 JQuickSQL.embedded 与 registerTable 完成 Java 案例。

标签：jquick-sql、LIMIT 分页、SQL 分页、ORDER BY、Java 跨库查询、轻量级 SQL 引擎

官网示例：

FORMULAS 示例页：https://www.jquick.org/jquick-sql

github 地址：https://github.com/paohaijiao/jquick-sql

前言

LIMIT 用于限制结果行数，是报表预览、列表分页和采样检查的基础能力。jquick-sql 在已注册的数据集上执行 LIMIT，不负责通过 JDBC 拉取远程表。对于上游已完成整合的异构数据源联邦查询结果，分页逻辑可保留在同一 SQL 层。

两种已验证的 LIMIT 语法

项目测试使用以下两种形式：

sql 复制代码

SELECT * FROM users LIMIT 3
SELECT * FROM users LIMIT 2, 3

前者返回最多三行；后者跳过前两行后返回最多三行。offset 从零开始理解更直观，例如首页通常是 LIMIT 0, 20。

分页必须配合 ORDER BY

未排序的数据集不应被视为稳定分页顺序。应先排序，再截取：

sql 复制代码

SELECT id, name, age
FROM users
ORDER BY age ASC
LIMIT 0, 3

如果排序字段可能重复，可追加确定性的次级字段，例如 ORDER BY age ASC, id ASC，使多页之间的结果更可预测。

控制返回规模的实践

LIMIT 适合控制展示层和批处理阶段的结果量，但不是权限过滤替代品。应先用 WHERE 限制可见范围，再排序和分页。Java 分布式 SQL 查询引擎执行前仍需由应用完成数据接入和注册。

可执行 Java 案例

java 复制代码

import com.github.paohaijiao.engine.JQuickSQL;
import com.github.paohaijiao.statement.JQuickColumnMeta;
import com.github.paohaijiao.statement.JQuickDataSet;
import com.github.paohaijiao.statement.JQuickRow;
import java.util.Arrays;

public class LimitPaginationDemo {
    public static void main(String[] args) {
        JQuickSQL sql = JQuickSQL.embedded();
        try {
            sql.registerTable("users", Arrays.asList(
                new JQuickColumnMeta("id", Integer.class, "users"),
                new JQuickColumnMeta("name", String.class, "users"),
                new JQuickColumnMeta("age", Integer.class, "users")
            ), Arrays.asList(
                row("id", 1, "name", "Alice", "age", 25),
                row("id", 2, "name", "Bob", "age", 30),
                row("id", 3, "name", "Charlie", "age", 20),
                row("id", 4, "name", "David", "age", 35)
            ));
            JQuickDataSet result = sql.execute(
                "SELECT id, name, age FROM users ORDER BY age ASC, id ASC LIMIT 1, 2"
            );
            result.printTable();
        } finally {
            sql.shutdown();
        }
    }
    private static JQuickRow row(Object... kv) {
        JQuickRow r = new JQuickRow();
        for (int i = 0; i < kv.length; i += 2) r.put((String) kv[i], kv[i + 1]);
        return r;
    }
}

常见问题

**LIMIT 2, 3 中的 2 是页码吗？**不是，是需要跳过的行数。

**不写 ORDER BY 能分页吗？**语法可执行，但结果顺序不应作为稳定业务契约。

**LIMIT 是否会从数据库分页读取？**不会；jquick-sql 对已注册数据集执行查询。

总结与拓展

LIMIT 让轻量级 SQL 引擎可按需裁剪查询输出。配合 WHERE、ORDER BY 和一致的接入数据模型，可为 Java 跨库查询的列表服务、审核页面和小批量处理提供清晰分页语义。

Core Advantage

LIMIT caps embedded query output with simple, test-backed SQL syntax.

Applicable Scenarios

List pages, preview APIs, batch sampling, and sorted operational reports.