Home

Awesome

Python cx_Oracle

News

cx_Oracle has a major new release under a new name and homepage python-oracledb.

The source code has moved to github.com/oracle/python-oracledb.

New projects should install python-oracledb instead of cx_Oracle. Critical patches and binary packages for new Python releases may continue to be made in the cx_Oracle namespace for a limited time, subject to demand.

About

cx_Oracle is a Python extension module that enables access to Oracle Database. It conforms to the Python database API 2.0 specification with a considerable number of additions and a couple of exclusions. See the homepage for a feature list.

cx_Oracle 8.3 was tested with Python versions 3.6 through 3.10. You can use cx_Oracle with Oracle 11.2, 12c, 18c, 19c and 21c client libraries. Oracle's standard client-server version interoperability allows connection to both older and newer databases. For example Oracle 19c client libraries can connect to Oracle Database 11.2. Older versions of cx_Oracle may work with older versions of Python.

Installation

See cx_Oracle Installation.

Documentation

See the cx_Oracle Documentation and Release Notes.

Samples

See the /samples directory and the tutorial. You can also look at the scripts in cx_OracleTools and the modules in cx_PyOracleLib.

Help

Issues and questions can be raised with the cx_Oracle community on GitHub or on the mailing list.

Tests

See /test.

Contributing

The cx_Oracle driver was renamed to python-oracledb in May 2022. It has a new repository at https://github.com/oracle/python-oracledb

Please submit your contributions to the python-oracledb repository.

No further releases under the cx_Oracle namespace are planned.

Security

Please consult the security guide for our responsible security vulnerability disclosure process.

License

cx_Oracle is licensed under a BSD license which you can find here.