7.6. LIMIT
и OFFSET
Указания LIMIT
и OFFSET
позволяют получить только часть строк из тех, что выдал остальной запрос:
SELECTсписок_выборки
FROMтабличное_выражение
[ ORDER BY ... ] [ LIMIT {число
| ALL } ] [ OFFSETчисло
]
Если указывается число LIMIT, в результате возвращается не больше заданного числа строк (меньше может быть, если сам запрос выдал меньшее количество строк). LIMIT ALL
равносильно отсутствию указания LIMIT
, как и LIMIT
с аргументом NULL.
OFFSET
указывает пропустить указанное число строк, прежде чем начать выдавать строки. OFFSET 0
равносильно отсутствию указания OFFSET
, как и OFFSET
с аргументом NULL.
Если указано и OFFSET
, и LIMIT
, сначала система пропускает OFFSET
строк, а затем начинает подсчитывать строки для ограничения LIMIT
.
Применяя LIMIT
, важно использовать также предложение ORDER BY
, чтобы строки результата выдавались в определённом порядке. Иначе будут возвращаться непредсказуемые подмножества строк. Вы можете запросить строки с десятой по двадцатую, но какой порядок вы имеете в виду? Порядок будет неизвестен, если не добавить ORDER BY
.
Оптимизатор запроса учитывает ограничение LIMIT
, строя планы выполнения запросов, поэтому вероятнее всего планы (а значит и порядок строк) будут меняться при разных LIMIT
и OFFSET
. Таким образом, различные значения LIMIT
/OFFSET
, выбирающие разные подмножества результатов запроса, приведут к несогласованности результатов, если не установить предсказуемую сортировку с помощью ORDER BY
. Это не ошибка, а неизбежное следствие того, что SQL не гарантирует вывод результатов запроса в некотором порядке, если порядок не определён явно предложением ORDER BY
.
Строки, пропускаемые согласно предложению OFFSET
, тем не менее должны вычисляться на сервере. Таким образом, при больших значениях OFFSET
работает неэффективно.
7.6. LIMIT
and OFFSET
LIMIT
and OFFSET
allow you to retrieve just a portion of the rows that are generated by the rest of the query:
SELECTselect_list
FROMtable_expression
[ ORDER BY ... ] [ LIMIT {number
| ALL } ] [ OFFSETnumber
]
If a limit count is given, no more than that many rows will be returned (but possibly fewer, if the query itself yields fewer rows). LIMIT ALL
is the same as omitting the LIMIT
clause, as is LIMIT
with a NULL argument.
OFFSET
says to skip that many rows before beginning to return rows. OFFSET 0
is the same as omitting the OFFSET
clause, as is OFFSET
with a NULL argument.
If both OFFSET
and LIMIT
appear, then OFFSET
rows are skipped before starting to count the LIMIT
rows that are returned.
When using LIMIT
, it is important to use an ORDER BY
clause that constrains the result rows into a unique order. Otherwise you will get an unpredictable subset of the query's rows. You might be asking for the tenth through twentieth rows, but tenth through twentieth in what ordering? The ordering is unknown, unless you specified ORDER BY
.
The query optimizer takes LIMIT
into account when generating query plans, so you are very likely to get different plans (yielding different row orders) depending on what you give for LIMIT
and OFFSET
. Thus, using different LIMIT
/OFFSET
values to select different subsets of a query result will give inconsistent results unless you enforce a predictable result ordering with ORDER BY
. This is not a bug; it is an inherent consequence of the fact that SQL does not promise to deliver the results of a query in any particular order unless ORDER BY
is used to constrain the order.
The rows skipped by an OFFSET
clause still have to be computed inside the server; therefore a large OFFSET
might be inefficient.