summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorMariusz Felisiak <felisiak.mariusz@gmail.com>2017-08-12 21:06:49 +0200
committerGitHub <noreply@github.com>2017-08-12 21:06:49 +0200
commit489421b01562494ab506de5d30ea97d7b6b5df30 (patch)
tree3ccf4b471f71c44e48e17dd028bcdb7e2262cc8b /docs
parent47ccefeada926ffbccaa354dec7a987a7e7ca701 (diff)
Fixed #23546 -- Added kwargs support for CursorWrapper.callproc() on Oracle.
Thanks Shai Berger, Tim Graham and Aymeric Augustin for reviews and Renbi Yu for the initial patch.
Diffstat (limited to 'docs')
-rw-r--r--docs/releases/2.0.txt4
-rw-r--r--docs/topics/db/sql.txt12
2 files changed, 13 insertions, 3 deletions
diff --git a/docs/releases/2.0.txt b/docs/releases/2.0.txt
index c4f5a8147c..1584b87293 100644
--- a/docs/releases/2.0.txt
+++ b/docs/releases/2.0.txt
@@ -269,6 +269,10 @@ Models
* The new ``field_name`` parameter of :meth:`.QuerySet.in_bulk` allows fetching
results based on any unique model field.
+* :meth:`.CursorWrapper.callproc()` now takes an optional dictionary of keyword
+ parameters, if the backend supports this feature. Of Django's built-in
+ backends, only Oracle supports it.
+
Requests and Responses
~~~~~~~~~~~~~~~~~~~~~~
diff --git a/docs/topics/db/sql.txt b/docs/topics/db/sql.txt
index 94e08b8bef..969026e56e 100644
--- a/docs/topics/db/sql.txt
+++ b/docs/topics/db/sql.txt
@@ -350,10 +350,12 @@ is equivalent to::
Calling stored procedures
~~~~~~~~~~~~~~~~~~~~~~~~~
-.. method:: CursorWrapper.callproc(procname, params=None)
+.. method:: CursorWrapper.callproc(procname, params=None, kparams=None)
- Calls a database stored procedure with the given name and optional sequence
- of input parameters.
+ Calls a database stored procedure with the given name. A sequence
+ (``params``) or dictionary (``kparams``) of input parameters may be
+ provided. Most databases don't support ``kparams``. Of Django's built-in
+ backends, only Oracle supports it.
For example, given this stored procedure in an Oracle database:
@@ -372,3 +374,7 @@ Calling stored procedures
with connection.cursor() as cursor:
cursor.callproc('test_procedure', [1, 'test'])
+
+ .. versionchanged:: 2.0
+
+ The ``kparams`` argument was added.