Skip to content

Commit 8b79772

Browse files
committed
Remove now obsolete references to DPI-1054
1 parent 2a05991 commit 8b79772

File tree

1 file changed

+3
-31
lines changed

1 file changed

+3
-31
lines changed

doc/api.md

Lines changed: 3 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1769,10 +1769,6 @@ pool running out of connections.
17691769
When a connection is released, any ongoing transaction on the
17701770
connection is rolled back.
17711771

1772-
If ResultSets are not released or LOBs are still open when
1773-
`connection.close()` is called, then an error *DPI-1054: connection
1774-
cannot be closed when open statements or LOBs exist* will occur.
1775-
17761772
After releasing a connection to a pool, there is no
17771773
guarantee a subsequent `getConnection()` call gets back the same
17781774
database connection. The application must redo any ALTER SESSION
@@ -1845,10 +1841,7 @@ be passed into PL/SQL blocks, or inserted into the database.
18451841

18461842
When no longer required, Lobs created with `createLob()` should be
18471843
closed with [`lob.close()`](#lobclose) because Oracle Database
1848-
resources are held open if temporary LOBs are not closed. If LOBs are
1849-
still open when `connection.close()` is called, then an error
1850-
*DPI-1054: connection cannot be closed when open statements or LOBs
1851-
exist* will occur.
1844+
resources are held open if temporary LOBs are not closed.
18521845

18531846
Open temporary LOB usage can be monitored using the view
18541847
[`V$TEMPORARY_LOBS`][13].
@@ -2386,10 +2379,6 @@ LOB, such as those created by `createLob()`.
23862379

23872380
Once a Lob is closed, it cannot be bound.
23882381

2389-
If LOBs are still open when `connection.close()` is called, then an
2390-
error *DPI-1054: connection cannot be closed when open statements or
2391-
LOBs exist* will occur.
2392-
23932382
See [Closing Lobs](#closinglobs) for more discussion.
23942383

23952384
##### Parameters
@@ -2684,10 +2673,6 @@ Closes a ResultSet. Applications should always call this at the end
26842673
of fetch or when no more rows are needed. It should also be called if
26852674
no rows are ever going to be fetched from the ResultSet.
26862675

2687-
If you try to close a connection without closing a ResultSet then an
2688-
error *DPI-1054: connection cannot be closed when open statements or
2689-
LOBs exist* will occur.
2690-
26912676
#### <a name="getrow"></a> 7.2.2 `resultset.getRow()`
26922677

26932678
##### Prototype
@@ -3698,10 +3683,7 @@ rows can be fetched.
36983683
When all rows have been fetched, or the application does not want to
36993684
continue getting more rows, then the ResultSet should be freed using
37003685
[`close()`](#close). The ResultSet should also be explicitly closed
3701-
in the cases where no rows will be fetched from it. If you try to
3702-
close a connection without closing a ResultSet then an error
3703-
*DPI-1054: connection cannot be closed when open statements or LOBs
3704-
exist* will occur.
3686+
in the cases where no rows will be fetched from it.
37053687
37063688
REF CURSORS returned from a PL/SQL block via an `oracledb.CURSOR` OUT
37073689
binds are also available as a ResultSet. See
@@ -5281,16 +5263,6 @@ error *NJS-023: concurrent operations on a Lob are not allowed*.
52815263
The connection must be open when calling `lob.close()` on a temporary
52825264
LOB.
52835265
5284-
If you try to close a connection without closing an open Lob, then an
5285-
error *DPI-1054: connection cannot be closed when open statements or
5286-
LOBs exist* will occur. The error helps prevent 'Temporary LOB leaks'
5287-
that would cause the temporary tablespace to fill up. You should
5288-
review the application logic and explicitly close any open Lobs.
5289-
These temporary Lobs will have been created with `lob.createLob()` or
5290-
returned from the database, perhaps as the result of a SQL operation
5291-
like `substr()` on a Lob column. Persistent LOBs can be closed
5292-
without the connection being open.
5293-
52945266
The `lob.close()` method emits the [Node.js Stream][16] 'close' event
52955267
unless the Lob has already been closed explicitly or automatically.
52965268
@@ -6749,7 +6721,7 @@ When upgrading from node-oracledb version 1.13 to version 2.0:
67496721
are closed prior to calling
67506722
[`connection.close()`](#connectionclose). Otherwise you will get the
67516723
error *DPI-1054: connection cannot be closed when open statements or
6752-
LOBs exist*.
6724+
LOBs exist*. (*Note*: this limitation was removed in node-oracledb 2.1)
67536725
67546726
- Test applications to check if changes such as the improved property
67556727
validation uncover latent problems in your code.

0 commit comments

Comments
 (0)