2025年9月25日: PostgreSQL 18 发布!
支持的版本: 当前 (18) / 17 / 16 / 15 / 14 / 13
开发版本: devel
不支持的版本: 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1

7.6. LIMITOFFSET #

LIMITOFFSET 允许您仅检索查询其余部分生成的部分行。

SELECT select_list
    FROM table_expression
    [ ORDER BY ... ]
    [ LIMIT { count | ALL } ]
    [ OFFSET start ]

如果给定了限制计数,则最多返回该数量的行(但如果查询本身产生的行数少于该数量,则可能返回更少)。LIMIT ALL 与省略 LIMIT 子句相同,LIMIT 带有 NULL 参数也与此相同。

OFFSET 表示在开始返回行之前跳过指定数量的行。OFFSET 0 与省略 OFFSET 子句相同,OFFSET 带有 NULL 参数也与此相同。

如果同时出现 OFFSETLIMIT,则在开始计算要返回的 LIMIT 行之前,会跳过 OFFSET 行。

使用 LIMIT 时,使用约束结果行以产生唯一顺序的 ORDER BY 子句非常重要。否则,您将获得查询行的不可预测的子集。您可能正在请求第十行到第二十行,但这是在什么顺序下的第十行到第二十行?除非您指定了 ORDER BY,否则顺序是未知的。

查询优化器在生成查询计划时会考虑 LIMIT,因此根据您为 LIMITOFFSET 提供的值,您很可能会获得不同的计划(产生不同的行顺序)。因此,使用不同的 LIMIT/OFFSET 值来选择查询结果的不同子集,将导致结果不一致,除非您使用 ORDER BY 来强制执行可预测的结果顺序。这不是错误;这是 SQL 不保证以任何特定顺序返回查询结果的固有结果,除非使用 ORDER BY 来约束顺序。

OFFSET 子句跳过的行仍然需要在服务器内部进行计算;因此,较大的 OFFSET 可能会效率低下。

提交更正

如果您在文档中发现任何不正确、与您对特定功能的体验不符或需要进一步澄清的内容,请使用 此表单 报告文档问题。