LIMIT 句

LIMIT 句は、クエリの結果として返される行数を制御します。

基本構文

先頭の行を選択:

LIMIT m

結果セットから先頭の m 行を返します。結果セットのレコード数が m 未満の場合は、すべてのレコードを返します。

代替 TOP 構文（MS SQL Server 互換）：

-- SELECT TOP 数値|パーセント カラム名 FROM テーブル名
SELECT TOP 10 * FROM numbers(100);
SELECT TOP 0.1 * FROM numbers(100);

これは LIMIT m と同等であり、Microsoft SQL Server 用のクエリとの互換性を保つために使用できます。

オフセット指定付き SELECT:

LIMIT m OFFSET n
-- または同等に:
LIMIT n, m

最初の n 行をスキップし、その後の m 行を返します。

どちらの形式でも、n と m は 0 以上の整数でなければなりません。

負の値を使用して、結果セットの末尾から行を選択します。

LIMIT -n, -m 構文は LIMIT -m OFFSET -n と同等です。

0 から 1 の間の小数値を使って、行の一定割合を選択できます:

注記

標準の整数と小数や負のオフセットを組み合わせて使用できます。

LIMIT 10 OFFSET 0.5    -- 中間地点から10行
LIMIT 10 OFFSET -20    -- 最後の20行をスキップした後の10行

WITH TIES 修飾子は、LIMIT 句で取得される最後の行と同じ ORDER BY の値を持つ行を、追加で結果に含めます。

SELECT * FROM (
    SELECT number % 50 AS n FROM numbers(100)
) ORDER BY n LIMIT 0, 5

┌─n─┐
│ 0 │
│ 0 │
│ 1 │
│ 1 │
│ 2 │
└───┘

WITH TIES を指定すると、最後の値と同じ値を持つすべての行が含まれます。

SELECT * FROM (
    SELECT number % 50 AS n FROM numbers(100)
) ORDER BY n LIMIT 0, 5 WITH TIES

┌─n─┐
│ 0 │
│ 0 │
│ 1 │
│ 1 │
│ 2 │
│ 2 │
└───┘

行 6 は、行 5 と同じ値（2）を持つため含まれます。

注記

WITH TIES は負の LIMIT 値ではサポートされていません。

この修飾子は、ORDER BY ... WITH FILL 修飾子と組み合わせて使用できます。

非決定的な結果: ORDER BY 句がない場合、返される行は任意のものとなり、クエリの実行ごとに結果が変わる可能性があります。

サーバー側の制限: 返される行数は、limit 設定によっても影響を受けます。