github/rails
1
1
Fork 0
mirror of https://github.com/github/rails.git synced 2026-04-26 03:00:59 -04:00
Code Issues Packages Projects Releases Wiki Activity

AR queying guide: let limit and offset be different numbers to help making clear what is what in the explanation, rewords also a bit

Browse Source
This commit is contained in:
Xavier Noria
2010-07-14 13:17:01 +02:00
parent 438bff6ccd
commit 5994567839
1 changed files with 6 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
railties/guides/source/active_record_querying.textile
View File

@@ -447,28 +447,28 @@ h4. Limit and Offset
To apply +LIMIT+ to the SQL fired by the +Model.find+, you can specify the +LIMIT+ using +limit+ and +offset+ methods on the relation.
You can use +limit+ to specify the number of records to be retrieved, and use +offset+ to specify the number of records to skip before starting to return the records. For example:
You can use +limit+ to specify the number of records to be retrieved, and use +offset+ to specify the number of records to skip before starting to return the records. For example
<ruby>
Client.limit(5)
</ruby>
This code will return a maximum of 5 clients and because it specifies no offset it will return the first 5 clients in the table. The SQL it executes will look like this:
will return a maximum of 5 clients and because it specifies no offset it will return the first 5 in the table. The SQL it executes looks like this:
<sql>
SELECT * FROM clients LIMIT 5
</sql>
Or chaining both +limit+ and +offset+:
Adding +offset+ to that
<ruby>
Client.limit(5).offset(5)
Client.limit(5).offset(30)
</ruby>
This code will return a maximum of 5 clients beginning with the 6th client in the clients table, skipping the first five clients as specified by the offset. The SQL looks like:
will return instead a maximum of 5 clients beginning with the 31st. The SQL looks like:
<sql>
SELECT * FROM clients LIMIT 5, 5
SELECT * FROM clients LIMIT 5, 30
</sql>
h4. Group