HackBase/python-cx_Oracle
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Adjust documentation to provide additional information on the use of

Browse Source 
cursor.executemany() as requested
(https://github.com/oracle/python-cx_Oracle/issues/153).
This commit is contained in:
Anthony Tuininga 2018-03-21 13:38:08 -06:00
parent e15851220b
commit 2901740faa
1 changed files with 11 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
doc/src/cursor.rst
View File

@ -176,7 +176,11 @@ Cursor Object
Prepare a statement for execution against a database and then execute it Prepare a statement for execution against a database and then execute it
against all parameter mappings or sequences found in the sequence against all parameter mappings or sequences found in the sequence
parameters. The statement is managed in the same way as the parameters. The statement is managed in the same way as the
:meth:`~Cursor.execute()` method manages it. :meth:`~Cursor.execute()` method manages it. If the size of the buffers
allocated for any of the parameters exceeds 2 GB, you will receive the
error "DPI-1015: array size of <n> is too large", where <n> varies with the
size of each element being allocated in the buffer. If you receive this
error, decrease the number of elements in the sequence parameters.
When true, the batcherrors parameter enables batch error support within When true, the batcherrors parameter enables batch error support within
Oracle and ensures that the call succeeds even if an exception takes place Oracle and ensures that the call succeeds even if an exception takes place
@ -187,6 +191,12 @@ Cursor Object
retrieved from Oracle after the method has completed. The row counts can retrieved from Oracle after the method has completed. The row counts can
then be retrieved using :meth:`~Cursor.getarraydmlrowcounts()`. then be retrieved using :meth:`~Cursor.getarraydmlrowcounts()`.
For maximum efficiency, it is best to use the
:meth:`~Cursor.setinputsizes()` method to specify the parameter types and
sizes ahead of time; in particular, None is assumed to be a string of
length 1 so any values that are later bound as numbers or dates will raise
a TypeError exception.
.. method:: Cursor.executemanyprepared(numIters) .. method:: Cursor.executemanyprepared(numIters)