Skip to content

Commit 4cd19d3

Browse files
committed
Add some bind description, using the word "escape" for searchability
1 parent ea68e76 commit 4cd19d3

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

doc/api.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3490,6 +3490,16 @@ Using bind parameters is recommended in preference to constructing SQL
34903490
or PL/SQL statements by string concatenation. This is for performance
34913491
and security.
34923492
3493+
Inserted data that is bound is passed to the database separately from
3494+
the statement text. It can never be executed. This means there is no
3495+
need to escape bound data inserted into the database.
3496+
3497+
If a statement is executed more than once with different values for
3498+
the bind parameters, Oracle can re-use context from the initial
3499+
execution, thus improving performance. However, if similar statements
3500+
contain hard coded values instead of bind parameters, Oracle sees the
3501+
statement text is different and would be less efficient.
3502+
34933503
IN binds are values passed into the database. OUT binds are used to
34943504
retrieve data. IN OUT binds are passed in, and may return a different
34953505
value after the statement executes.

0 commit comments

Comments
 (0)