python-oracledb——利用python连接Oracle数据库的利器

之前使用的数据库一直是MySql，偶尔使用PostgreSQL，都是利用的数据库连接池使用；

最近需要在Oracle数据库取数据，因此查找了一下连接的方法。网上大部分都是给出的使用cx_Oracle库进行连接，方法也比较简单。但是在进一步了解的时候发现cx_Oracle库 的最新版本已经升级为python-oracledb了；于是简单探究了一下。

python-oracledb驱动程序是一个Python扩展模块，可以访问Oracle数据库。它具有支持Python数据库API v2.0规范的全面功能，具有相当多的附加内容和一些排除项。

python-oracledb驱动程序是cx_Oracle 8.3的重命名的主要版本继承者。

python-oracledb功能亮点是：

1. 从 PyPI 轻松安装
2. 支持多个 Oracle 数据库版本；支持 Python 数据库 API v2.0 规范
   执行 SQL 和 PL/SQL 语句
3. 广泛的 Oracle 数据类型支持，包括 JSON、大型对象 （ 和 ） 和 SQL 对象的绑定CLOBBLOB
   连接管理，包括连接池Oracle 数据库高可用性功能
4. 充分利用 Oracle 网络服务基础架构，包括加密的网络流量

python-oracledb 与 cx_Oracle 使用方法对比

cx_Oracle使用方法

import cx_Oracle

# 设置连接参数
connection = cx_Oracle.connect(user="hr", password="welcome",
                               dsn="localhost/orclpdb1")

cursor = connection.cursor()
cursor.execute("""
        SELECT first_name, last_name
        FROM employees
        WHERE department_id = :did AND employee_id > :eid""",
        did = 50,
        eid = 190)
for fname, lname in cursor:
    print("Values:", fname, lname)

python-oracledb的使用方法

安装方法：

python -m pip install oracledb

默认情况下，python-oracledb在“精简”模式下运行，该模式直接连接到Oracle数据库。此模式不需要 Oracle 客户端库。但是，当python-oracledb使用它们时，可以使用一些其他功能。Python-oracledb在使用Oracle客户端库时被称为“Thick”模式。这两种模式都具有支持 Python 数据库 API v2.0 规范的全面功能。
从默认的精简模式更改为Thick模式需要添加对 oracledb.init_oracle_client（） 的调用；当调用init_oracle_client（） 时，python-oracledb 使用搜索启发式方式动态加载 Oracle Client 库，
使用方法：

import oracledb

oracledb.init_oracle_client(lib_dir=r"D:\instantclient_21_6")

独立链接模式

一般方法：

import oracledb
import getpass

userpwd = getpass.getpass("Enter password: ")

connection = oracledb.connect(user="hr", password=userpwd,
                              dsn="dbhost.example.com/orclpdb")

# 其他功能代码

# 关闭连接
connection.close()

或者可以使用以下方法：

username="hr"
userpwd = os.environ.get("PYTHON_PASSWORD")
host = "localhost"
port = 1521
service_name = "orclpdb"

dsn = f'{username}/{userpwd}@{port}:{host}/{service_name}'
connection = oracledb.connect(dsn)

# 其他功能代码

# 关闭连接
connection.close()

使用连接池的方法

# 初始化连接
pool = oracledb.create_pool(user="hr", password=userpwd, dsn="dbhost.example.com/orclpdb",
                            min=2, max=5, increment=1)

# Acquire 连接到池
connection = pool.acquire()

# 使用连接池
with connection.cursor() as cursor:
    for result in cursor.execute("select * from mytab"):
        print(result)

# 释放连接池
pool.release(connection)

# 关闭连接池
pool.close()

还有很多其他功能，后续在逐步探索使用。

更多功能学习，参考官方指导。

官方示例代码