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

Mention SQL_TRACE

This commit is contained in:
Christopher Jones 2018-03-27 16:08:15 +11:00
parent 8e0a6a3e4b
commit bd4a10fbc2
1 changed files with 20 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
doc/api.md
View File

@ -6728,11 +6728,26 @@ using async functions][74].
## <a name="bindtrace"></a> <a name="tracingsql"></a> 22. Tracing SQL and PL/SQL Statements
#### End-to-End Tracing
Applications that have implemented [End-to-end Tracing](#endtoend)
calls such as [action](#propconnaction) and [module](#propconnmodule),
will make it easier in database monitoring tools to identify SQL
statement execution.
#### Tracing Executed Statements
Database statement tracing is commonly used to identify performance
issues. Oracle Database trace files can be analyzed after statements
are executed. Tracing can be enabled in various ways at a database
system or individal session level. Refer to [Oracle Database Tuning
documentation][95]. Setting a customer identifier is recommended to
make searching for relevant log files easier:
```
ALTER SESSION SET tracefile_identifier='My-identifier' SQL_TRACE=TRUE
```
In node-oracledb itself, the [ODPI-C tracing capability][75] can be
used to log executed statements to the standard error stream. Before
executing Node.js, set the environment variable `DPI_DEBUG_LEVEL`
@ -6752,6 +6767,8 @@ identifier, a timestamp, and the SQL statement executed:
ODPI [6905309] 2017-09-13 09:02:46.140: SQL select sysdate from dual where :b = 1
```
#### Tracing Bind Values
Sometimes it is useful to trace the bind data values that have been
used when executing statements. Several methods are available.
@ -6762,6 +6779,8 @@ capture bind information. Tracing with Oracle Database's
You can also write your own wrapper around `execute()` and log any
parameters.
#### Other Tracing Utilities
PL/SQL users may be interested in using [PL/Scope][78].
## <a name="migrate"></a> 23. Migrating from Previous node-oracledb Releases
@ -6926,3 +6945,4 @@ When upgrading from node-oracledb version 2.0 to version 2.1:
[92]: https://nodejs.org/api/stream.html#stream_readable_destroy_error
[93]: https://docs.oracle.com/en/database/oracle/oracle-database/12.2/racad/introduction-to-oracle-rac.html#GUID-D04AA2A7-2E68-4C5C-BD6E-36C62427B98E
[94]: https://github.com/oracle/node-oracledb/blob/node-oracledb-v1/doc/api.md
[95]: https://docs.oracle.com/en/database/oracle/oracle-database/12.2/tgsql/toc.htm