rdelaage
/
postgresql
mirror of https://git.postgresql.org/git/postgresql.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Docs: clarify description of LIMIT/OFFSET behavior. 

Section 7.6 was a tad confusing because it specified what LIMIT NULL
does, but neglected to do the same for OFFSET NULL, making this look
like perhaps a special case or a wrong restatement of the bit about
LIMIT ALL.  Wordsmith a bit while at it.  Per bug #14084.
This commit is contained in:
Tom Lane 2016-04-14 10:57:29 -04:00
parent 22989a8e34
commit fda21aa05b
1 changed files with 7 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
doc/src/sgml/queries.sgml
View File

@ -1794,16 +1794,19 @@ SELECT <replaceable>select_list</replaceable>
<para> <para>
If a limit count is given, no more than that many rows will be If a limit count is given, no more than that many rows will be
returned (but possibly less, if the query itself yields less rows). returned (but possibly fewer, if the query itself yields fewer rows).
<literal>LIMIT ALL</> is the same as omitting the <literal>LIMIT</> <literal>LIMIT ALL</> is the same as omitting the <literal>LIMIT</>
clause. clause, as is <literal>LIMIT</> with a NULL argument.
</para> </para>
<para> <para>
<literal>OFFSET</> says to skip that many rows before beginning to <literal>OFFSET</> says to skip that many rows before beginning to
return rows. <literal>OFFSET 0</> is the same as omitting the return rows. <literal>OFFSET 0</> is the same as omitting the
<literal>OFFSET</> clause, and <literal>LIMIT NULL</> is the same <literal>OFFSET</> clause, as is <literal>OFFSET</> with a NULL argument.
as omitting the <literal>LIMIT</> clause. If both <literal>OFFSET</> </para>
<para>
If both <literal>OFFSET</>
and <literal>LIMIT</> appear, then <literal>OFFSET</> rows are and <literal>LIMIT</> appear, then <literal>OFFSET</> rows are
skipped before starting to count the <literal>LIMIT</> rows that skipped before starting to count the <literal>LIMIT</> rows that
are returned. are returned.