Python连接Oracle数据库：cx_Oracle与oracledb库的比较与选择

文章目录

- - 一、概述
  - - cx_Oracle
    - oracledb
  - 二、安装Oracle Instant client
  - 三、Python测试
  - - cx_Oracle：
    - oracledb：

一、概述

Python 访问 Oracle可以通过两种Oracle官方库：

旧驱动：cx_Oracle（需要安装Oracle Instant client）

新驱动：oracledb（Oracle数据库12.1或更高版本不需要安装 Oracle Instant client）

cx_Oracle

需要安装 Oracle Instant client（Oracle即时客户端）。

oracledb

GitHub：https://github.com/oracle/python-oracledb

python-oracledb 有两种模式： Thin 和 Thick。

默认模式是Thin，该模式直接连接到 Oracle数据库，不需要Oracle客户端库。
Thin模式只支持Oracle数据库12.1或更高版本。
Thick模式需要Oracle客户端库。

二、安装Oracle Instant client

官方下载地址：https://www.oracle.com/database/technologies/instant-client/downloads.html

官方安装手册：https://cx-oracle.readthedocs.io/en/latest/user_guide/installation.html#installing-cx-oracle-on-macos-intel-x86

截止目前（20240611），最新版本instantclient-basic-macos.x64-19.16.0.0.0dbru.dmg 客户端经测试可以访问Oracle 11.2.0.2.0。

以下是在macos上安装 instantclient-basic-macos.x64-19.16.0.0.0dbru.dmg 步骤：

cd $HOME/Downloads
# 1.下载 instantclient-basic-macos.x64-19.16.0.0.0dbru.dmg# 2.挂载下载的DMG文件
双击 instantclient-basic-macos.x64-19.8.0.0.0dbru.dmg# 3.默认安装在$HOME/Downloads（如果不介意，则完成后直接跳到第 5 步）
复制全部文件到自定义文件夹# 4.修改安装文件
vim install_ic.shDEST=/Users/${USER}/Downloads/instantclient_19_16 
修改为自己创建的目录：
DEST=/Users/wangfugui/home/dev/middleware/数据库/Oracle/instantclient/instantclient_19_16# 5.安装客户端
sh install_ic.sh

（非必须）如果要安装sdk、sqlplus，按照上面的方法，将文件复制到同一个目录中 instantclient_19_16，修改目录并执行安装。

三、Python测试

cx_Oracle：

需要安装 Oracle Instant client。

import cx_Oraclecx_Oracle.init_oracle_client(lib_dir="/Users/wangfugui/home/dev/middleware/数据库/Oracle/instantclient/instantclient_19_16")
connection = cx_Oracle.connect(user="oracle", password="oracle",dsn="localhost/XE")cursor = connection.cursor()
cursor.execute("""SELECT first_name, last_nameFROM employeesWHERE EMPLOYEE_ID > :did AND EMPLOYEE_ID < :eid""",did = 101,eid = 104)
for fname, lname in cursor:print("Values:", fname, lname)

oracledb：

Oracle数据库12.1或更高版本不需要安装 Oracle Instant client。

import getpassimport oracledbun = 'oracle'
cs = 'localhost/XE'
pw = getpass.getpass(f'Enter password for {un}@{cs}: ')with oracledb.connect(user=un, password=pw, dsn=cs) as connection:with connection.cursor() as cursor:sql = """SELECT * FROM employees"""for r in cursor.execute(sql):print(r)