dnrops
/
python-oracledb
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Show how to correctly bind data to insert into NVARCHAR2 columns.

This commit is contained in:
Anthony Tuininga 2023-01-18 10:02:37 -07:00
parent 1d1e17144d
commit b07a524373
2 changed files with 20 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
doc/src/api_manual/module.rst
View File

@ -2387,7 +2387,7 @@ version of python-oracledb.
.. data:: NCHAR
A synonym for :data:`DB_TYPE_NVARCHAR`.
A synonym for :data:`DB_TYPE_NCHAR`.
.. deprecated:: cx_Oracle 8.0

19
doc/src/user_guide/globalization.rst
View File

@ -215,3 +215,22 @@ To convert dates:
for row in cursor:
print(row) # gives 'Mi 15 Dez 19:57:56 2021'
print()
Inserting NVARCHAR2 and NCHAR Data
----------------------------------
To bind NVARCHAR2 data, use :func:`Cursor.setinputsizes()` or create a bind
variable with the correct type by calling :func:`Cursor.var()`. This removes
an internal character set conversion to the standard `Database Character Set`_
that may corrupt data. By binding as :data:`oracledb.DB_TYPE_NVARCHAR`, the
data is inserted directly as the `Database National Character Set`_. For
example, to insert into a table containing two NVARCHAR2 columns:
.. code-block:: python
sql = "insert into mytable values (:1, :2)"
bv = ['data1', 'data2']
cursor.setinputsizes(oracledb.DB_TYPE_NVARCHAR, oracledb.DB_TYPE_NVARCHAR)
cursor.execute(sql, bv)
For NCHAR data, bind as :data:`oracledb.DB_TYPE_NCHAR`.