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
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.