From d85e90a468aecc639ede279eb488348a9f18b187 Mon Sep 17 00:00:00 2001 From: Anthony Tuininga Date: Wed, 24 May 2017 12:00:31 -0600 Subject: [PATCH] Add note that SQL and PL/SQL statements are handled differently when binding by position and that binding by name is generally recommended. --- doc/src/cursor.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/doc/src/cursor.rst b/doc/src/cursor.rst index 2a2b24d9..de280a0b 100644 --- a/doc/src/cursor.rst +++ b/doc/src/cursor.rst @@ -137,7 +137,9 @@ Cursor Object dictionary, the values will be bound by name and if the arguments are a sequence the values will be bound by position. Note that if the values are bound by position, the order of the variables is from left to right as they - are encountered in the statement. + are encountered in the statement and SQL statements are processed + differently than PL/SQL statements. For this reason, it is generally + recommended to bind parameters by name instead of by position. A reference to the statement will be retained by the cursor. If None or the same string object is passed in again, the cursor will execute that