dnrops
/
node-oracledb
mirror of https://github.com/oracle/node-oracledb
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Fix an unbalanced paren in doc and do some tidy up

This commit is contained in:
Christopher Jones 2019-02-14 11:42:20 +11:00
parent 1d4736a96b
commit 43a4eccd16
1 changed files with 13 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
doc/api.md
View File

@ -1165,7 +1165,7 @@ This property may be overridden in an [`execute()`](#executeoptions)
call.
To improve database efficiency, SQL queries should use a row limiting
clause like [OFFSET / FETCH](#pagingdata) or equivalent. The `maxRows`
clause like [`OFFSET` / `FETCH`](#pagingdata) or equivalent. The `maxRows`
property can be used to stop badly coded queries from returning
unexpectedly large numbers of rows.
@ -7461,7 +7461,7 @@ Any rows beyond the `maxRows` limit are not returned. If `maxRows` is
0, then the number of rows is only limited by Node.js memory.
To improve database efficiency, SQL queries should use a row limiting
clause like [OFFSET / FETCH](#pagingdata) or equivalent. The `maxRows`
clause like [`OFFSET` / `FETCH`](#pagingdata) or equivalent. The `maxRows`
property can be used to stop badly coded queries from returning
unexpectedly large numbers of rows.
@ -8138,9 +8138,9 @@ How to do 'web pagination' is discussed in this section. For each
of rows from a table. Since the query will be executed more than
once, make sure to use bind variables for row numbers and row limits.
Oracle Database 12c SQL has an `OFFSET` / `FETCH` clause (See [Row
Limiting: Examples][5], which is similar to the LIMIT keyword of
MySQL.
Oracle Database 12c SQL introduced an `OFFSET` / `FETCH` clause which
is similar to the LIMIT keyword of MySQL. See [Row Limiting:
Examples][5] in the Oracle documentation. A node-oracledb example is:
```javascript
var myoffset = 0; // do not skip any rows (start at row 1)
@ -8155,7 +8155,7 @@ connection.execute(
. . .
```
See [rowlimit.js][84].
A runnable example is in [rowlimit.js][84].
You can use a basic [`execute()`](#execute) or a
[ResultSet](#resultsetclass), or [`queryStream()`](#querystream) with
@ -8173,10 +8173,8 @@ efficient to let Oracle Database do the row selection in the SQL query
and only return the exact number of rows required to node-oracledb.
For Oracle Database 11g and earlier there are several alternative ways
to limit the number of rows returned. Refer to [Oracle Magazine][85]
for details.
The old, canonical paging query is:
to limit the number of rows returned. The old, canonical paging query
is:
```SQL
SELECT *
@ -8211,6 +8209,9 @@ SELECT last_name FROM
WHERE myr BETWEEN 1 and 20
```
Refer to [On Top-n and Pagination Queries][85] in Oracle Magazine for
details.
#### <a name="autoincrement"></a> 13.1.8 Auto-Increment Columns
From Oracle Database 12c you can create tables with auto-incremented
@ -11979,8 +11980,8 @@ When upgrading from node-oracledb version 1.13 to version 2.0:
- For [direct fetches](#fetchingrows) that relied on the version 1
default value of [`maxRows`](#propdbmaxrows) to limit the number of
returned rows to 100, it is recommended to use an [OFFSET /
FETCH](#pagingdata) query clause. Alternatively explicitly set
returned rows to 100, it is recommended to use an [`OFFSET` /
`FETCH`](#pagingdata) query clause. Alternatively explicitly set
`maxRows` to 100.
- Review and update code that checks for specific *NJS-XXX* or