推荐优先使用 oracledb（oracle 官方推荐、纯 python 实现、默认 thin 模式无需客户端），安装 pip install oracledb，支持 easy connect 连接字符串、连接池、thick 模式及常见问题处理。
Python 连接 Oracle 数据库，主流方式是使用 cx_Oracle（旧版）或其继任者 oracledb（Oracle 官方推荐、纯 Python 实现、无需 Oracle 客户端）。推荐优先使用 oracledb，尤其新项目。
安装 oracledb（推荐）
执行命令安装：
pip install oracledb
注意：oracledb 无需安装 Oracle Instant Client（除非使用 Thick 模式），默认运行在 Thin 模式，开箱即用。
基本连接与查询
使用用户名、密码、主机、端口和 SID 或服务名构造连接字符串。常见写法如下：
立即学习“Python免费学习笔记（深入）”；
- 使用 Easy Connect 字符串（最简）：
"username/password@host:port/service_name" - 使用完整 TNS 格式（适合复杂网络配置）：
"username/password@//host:port/service_name"
示例代码：
import oracledb
<h1>连接</h1><p>conn = oracledb.connect(
user="scott",
password="tiger",
dsn="localhost:1521/orclpdb1" # 或 "localhost:1521/ORCLPDB1"
)</p><h1>创建游标并查询</h1><p>cursor = conn.cursor()
cursor.execute("SELECT * FROM employees WHERE ROWNUM <= 5")
for row in cursor:
print(row)</p><p>cursor.close()
conn.close()处理连接参数与配置
生产环境建议用连接池提升性能，避免频繁创建/关闭连接：
- 调用
oracledb.create_pool()创建连接池 - 从池中获取连接：
pool.acquire()，用完归还：pool.release(conn) - 可设置最小/最大连接数、超时时间等参数
若需兼容旧系统或使用高级功能（如 LDAP、高级队列），可启用 Thick 模式（需先安装 Oracle Instant Client）：
oracledb.init_oracle_client(lib_dir="/path/to/instantclient")
