https://github.com/oracle/python-cx_oracle

Python interface to Oracle Database now superseded by python-oracledb
https://github.com/oracle/python-cx_oracle

database-connector db-connection odpi oracle-database oracle-db python python-library python-module

Last synced: 4 days ago
JSON representation

Python interface to Oracle Database now superseded by python-oracledb

• Host: GitHub
• URL: https://github.com/oracle/python-cx_oracle
• Owner: oracle
• License: other
• Created: 2017-03-07T04:03:36.000Z (almost 8 years ago)
• Default Branch: main
• Last Pushed: 2024-07-30T23:10:14.000Z (5 months ago)
• Last Synced: 2024-12-12T02:02:09.330Z (11 days ago)
• Topics: database-connector, db-connection, odpi, oracle-database, oracle-db, python, python-library, python-module
• Language: C
• Homepage: https://oracle.github.io/python-cx_Oracle
• Size: 7.32 MB
• Stars: 887
• Watchers: 74
• Forks: 363
• Open Issues: 27
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.txt
  • Security: SECURITY.md
  • Support: .github/SUPPORT.md

Awesome Lists containing this project

README

        
# Python cx_Oracle

# News

**cx_Oracle has a major new release under a new name and homepage

[python-oracledb](https://oracle.github.io/python-oracledb/).**

**The source code has moved to

[github.com/oracle/python-oracledb](https://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][1] with a considerable number of additions and a couple

of exclusions.  See the

[homepage](https://oracle.github.io/python-cx_Oracle/index.html) 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][15].

## Documentation

See the [cx_Oracle Documentation][2] and [Release Notes][14].

## Samples

See the [/samples][12] directory and the [tutorial][6].  You can also

look at the scripts in [cx_OracleTools][7] and the modules in

[cx_PyOracleLib][8].

## Help

Issues and questions can be raised with the cx_Oracle community on

[GitHub][9] or on the [mailing list][5].

## Tests

See [/test][11].

## 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](./SECURITY.md) for our responsible security

vulnerability disclosure process.

## License

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

[1]: https://peps.python.org/pep-0249/

[2]: https://cx-oracle.readthedocs.io

[3]: https://github.com/oracle/python-cx_Oracle/blob/main/LICENSE.txt

[5]: https://sourceforge.net/projects/cx-oracle/lists/cx-oracle-users

[6]: https://github.com/oracle/python-cx_Oracle/tree/main/samples/tutorial

[7]: http://cx-oracletools.sourceforge.net

[8]: http://cx-pyoraclelib.sourceforge.net

[9]: https://github.com/oracle/python-cx_Oracle/issues

[11]: https://github.com/oracle/python-cx_Oracle/tree/main/test

[12]: https://github.com/oracle/python-cx_Oracle/tree/main/samples

[14]: https://cx-oracle.readthedocs.io/en/latest/release_notes.html

[15]: https://cx-oracle.readthedocs.io/en/latest/user_guide/installation.html