Adjust documentation to provide additional information on the use of

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

View File

@ -176,7 +176,11 @@ Cursor Object
Prepare a statement for execution against a database and then execute it
against all parameter mappings or sequences found in the sequence
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
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
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)