Open Source Python/Oracle Utility - cx_Oracle
---------------------------------------------
cx_Oracle is a Python extension module that enables access to Oracle Database
and conforms to the Python database API 2.0 specifications with a considerable
number of additions and a couple of exclusions. The time data type is not
supported by Oracle and is therefore not implemented. The method
cursor.nextset() is not implemented either as the DB API specification assumes
an implementation of cursors that does not fit well with Oracle's
implementation of cursors and implicit results. See the method
cursor.getimplicitresults() for more information.

See http://www.python.org/topics/database/DatabaseAPI-2.0.html for more
information on the Python database API specification. See the documentation at
http://cx-oracle.readthedocs.io for a complete description of the module's
capabilities.

cx_Oracle is licensed under a BSD license which you can find at
http://cx-oracle.readthedocs.io/en/latest/license.html.

Please note that an Oracle client (or server) installation is required in order
to use cx_Oracle. If you do not require the tools that come with a full client
installation, it is recommended to install the Instant Client
(http://www.oracle.com/technetwork/database/features/instant-client/index.html)
which is far easier to install.

For feedback or patches, contact Anthony Tuininga at
anthony.tuininga@gmail.com. For help or to ask questions, please use the
mailing list at http://lists.sourceforge.net/lists/listinfo/cx-oracle-users.


Installation
------------
Binaries for some platforms and Oracle versions are available at
https://pypi.python.org/pypi/cx_Oracle. If you prefer to build your own you
can use this command

    pip install cx_Oracle

which will download the source package, build and install it. Otherwise, you
can download the source package directly from PyPI, extract it and run these
commands instead

    python setup.py build
    python setup.py install

This module has been built with Oracle client 11.2, 12.1 and 12.2 on Linux and
Windows. Others have reported success with other platforms such as macOS.

See BUILD.txt for additional information.


Usage Example
-------------

from __future__ import print_function   # needed for Python 2.x

import cx_Oracle

# connect via SQL*Net string or by each segment in a separate argument
#connection = cx_Oracle.connect("user/password@TNS")
connection = cx_Oracle.connect("user", "password", "TNS")

cursor = connection.cursor()
cursor.execute("""
        select Col1, Col2, Col3
        from SomeTable
        where Col4 = :arg_1
          and Col5 between :arg_2 and :arg_3""",
        arg_1 = "VALUE",
        arg_2 = 5,
        arg_3 = 15)
for column_1, column_2, column_3 in cursor:
    print("Values:", column_1, column_2, column_3)


For more examples, please see the test suite in the test directory and the
samples in the samples directory. You can also look at the scripts in the
cx_OracleTools (http://cx-oracletools.sourceforge.net) and the modules in the
cx_PyOracleLib (http://cx-pyoraclelib.sourceforge.net) projects.