cx-Oracle

Python interface to Oracle


Keywords
Oracle, database, database-connector, db-connection, odpi, oracle-database, oracle-db, python, python-library, python-module
License
BSD-3-Clause
Install
pip install cx-Oracle==7.1.3

Documentation

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

See CONTRIBUTING

License

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