MySQL の LIMIT

VillageSQL is a drop-in replacement for MySQL with extensions.

All examples on this page work on VillageSQL. Install Now →

LIMIT はクエリが返す行数に上限を設けます。大きなテーブルの先頭を見るときに使うものであり、結果をページ送りする仕組みの土台でもあります。始める前に mysql -u root -p sakila でクライアントを開いてください。

LIMIT の仕組み

SELECT COLUMN_LIST
FROM TABLE_NAME
ORDER BY SORT_COLUMN
LIMIT ROW_COUNT OFFSET SKIP_COUNT;

ROW_COUNT を欲しい行数に、SKIP_COUNT を先に読み飛ばす行数に置き換えます。 LIMIT は ORDER BY の後、最後に置きます。OFFSET の部分は省略可能です。

例

最初の数行

SELECT title FROM film ORDER BY title LIMIT 5;

+------------------+
| title            |
+------------------+
| ACADEMY DINOSAUR |
| ACE GOLDFINGER   |
| ADAPTATION HOLES |
| AFFAIR PREJUDICE |
| AFRICAN EGG      |
+------------------+
5 rows in set (0.00 sec)

結果全体が 5 行なので、末尾の罫線と件数は切り詰めではなく本当の終わりです。

先にいくつか読み飛ばす

SELECT title FROM film ORDER BY title LIMIT 5 OFFSET 10;

+-----------------+
| title           |
+-----------------+
| ALAMO VIDEOTAPE |
| ALASKA PHANTOM  |
| ALI FOREVER     |
| ALICE FANTASIA  |
| ALIEN CENTER    |
+-----------------+
5 rows in set (0.00 sec)

ソートされたリストの 11 行目から 15 行目です。

数値 2 つの形式

MySQL はオフセットと件数を、オフセットを先にしたカンマ区切りの組としても受け付けます。意味はまったく同じです。

SELECT title FROM film ORDER BY title LIMIT 10, 5;

+-----------------+
| title           |
+-----------------+
| ALAMO VIDEOTAPE |
| ALASKA PHANTOM  |
| ALI FOREVER     |
| ALICE FANTASIA  |
| ALIEN CENTER    |
+-----------------+
5 rows in set (0.00 sec)

例 2 と同じ 5 タイトルです。2 つの数値は 2 つの形式の間で逆の順序になり、これが 1 つずれの混乱の確実な原因になるので、このチュートリアルでは LIMIT ROW_COUNT OFFSET SKIP_COUNT と書きます。

ORDER BY のない LIMIT は任意の行を求める

ORDER BY を外してもクエリは実行されます。

SELECT title FROM film LIMIT 5;

+------------------+
| title            |
+------------------+
| ACADEMY DINOSAUR |
| ACE GOLDFINGER   |
| ADAPTATION HOLES |
| AFFAIR PREJUDICE |
| AFRICAN EGG      |
+------------------+
5 rows in set (0.00 sec)

これはソートしたクエリが返したのと同じ 5 タイトルであり、それがこれを危険にしています。文の中の何も、その順序を求めていません。サーバーにクエリをどう実行したかを尋ねると、なぜその順で返ってきたかを教えてくれます。

EXPLAIN SELECT title FROM film LIMIT 5;

+----+-------------+-------+------------+-------+---------------+-----------+---------+------+------+----------+-------------+
| id | select_type | table | partitions | type  | possible_keys | key       | key_len | ref  | rows | filtered | Extra       |
+----+-------------+-------+------------+-------+---------------+-----------+---------+------+------+----------+-------------+
|  1 | SIMPLE      | film  | NULL       | index | NULL          | idx_title | 514     | NULL | 1000 |   100.00 | Using index |
+----+-------------+-------+------------+-------+---------------+-----------+---------+------+------+----------+-------------+
1 row in set, 1 warning (0.00 sec)

この 1 warning は追いかけるべきものではありません。EXPLAIN と EXPLAIN FORMAT=JSON は Note 1003 を付けます。これはオプティマイザが書き換えた後のクエリを保持しており、SHOW WARNINGS がそれを表示します。 key 列には idx_title とあります。これは title のインデックスで、既にその列をソートされた順に保持しているので、インデックスを読むのが最も安く答える方法です。行がソートされて届いたのは、その選択の副作用です。そのインデックスを削除する、選択リストに別の列を加える、サーバーにもっと多くのデータを与える、のいずれかをすれば、クエリを何も変えなくてもその選択は変わりえます。 LIMIT は、ORDER BY がどの行かを指定しない限り「任意の行」を意味します。

まとめ

返ってくる行数に上限を設けるには LIMIT を使います。
行を取る前に読み飛ばすには OFFSET を加えます。
カンマ形式は数値の順序が逆になるので、LIMIT ROW_COUNT OFFSET SKIP_COUNT のほうを選びます。
LIMIT には毎回 ORDER BY を組み合わせてください。さもなければ任意の行を求めたことになります。

MySQL Tutorial

ガイド

データの保存

クエリの作成

データの保護

パフォーマンスの最適化

AI で構築する

MySQL の運用

アプリケーションの接続

拡張機能の作成