Skip to content

Commit 4b57300

Browse files
committed
Tweak row limit doc
1 parent 8294027 commit 4b57300

File tree

1 file changed

+13
-10
lines changed

1 file changed

+13
-10
lines changed

doc/api.md

Lines changed: 13 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -9077,23 +9077,26 @@ See [Oracle Database Objects and Collections](#objects).
90779077
90789078
#### <a name="pagingdata"></a> 15.1.7 Limiting Rows and Creating Paged Datasets
90799079
9080-
Query data is commonly broken into small sets for two reasons:
9080+
Query data is commonly broken into one or more sets:
90819081
9082-
- 'Web pagination' that allows moving from one set of rows to a next,
9083-
or previous, set.
9082+
- To give an upper bound on the number of rows that a query has to process,
9083+
which can help improve database scalability.
90849084
9085-
- Fetching of consecutive small sets of data for processing. This
9086-
happens because the number of records is too large for Node.js to
9087-
handle at the same time.
9085+
- To perform 'Web pagination' that allows moving from one set of rows to a next,
9086+
or previous, set on demand.
9087+
9088+
- For fetching of all data in consecutive small sets for batch processing. This
9089+
happens because the number of records is too large for Python to handle at the
9090+
same time.
90889091
90899092
The latter can be handled by [ResultSets](#resultsethandling) or
90909093
[`queryStream()`](#querystream) with one execution of the SQL query as
90919094
discussed in those links.
90929095
9093-
How to do 'web pagination' is discussed in this section. For each
9094-
'page' of results, a SQL query is executed to get the appropriate set
9095-
of rows from a table. Since the query will be executed more than
9096-
once, make sure to use bind variables for row numbers and row limits.
9096+
'Web pagination' and limiting the maximum number of rows are discussed in this
9097+
section. For each 'page' of results, a SQL query is executed to get the
9098+
appropriate set of rows from a table. Since the query will be executed more
9099+
than once, make sure to use bind variables for row numbers and row limits.
90979100
90989101
Oracle Database 12c SQL introduced an `OFFSET` / `FETCH` clause which
90999102
is similar to the `LIMIT` keyword of MySQL. See [Row Limiting:

0 commit comments

Comments
 (0)