代码收藏家技术教程 2024-10-29

Python-oracledb 使用教程

python-oracledb Python driver for Oracle Database conforming to the Python DB API 2.0 specification. This is the renamed, new major release of cx_Oracle 项目地址: https://gitcode.com/gh_mirrors/py/python-oracledb

1. 项目介绍

python-oracledb 是一个用于连接 Oracle 数据库的 Python 扩展模块。它是 cx_Oracle 驱动程序的重命名和新版本，完全符合 Python DB API 2.0 规范，并提供了许多额外的功能。该模块支持同步和并发编程风格，适用于从 Python 3.8 到 Python 3.13 的版本。

2. 项目快速启动

安装

首先，确保你已经安装了 Python 3.8 或更高版本。然后，使用 pip 安装 python-oracledb：

python -m pip install oracledb

连接到 Oracle 数据库

以下是一个简单的示例，展示如何使用 python-oracledb 连接到 Oracle 数据库并执行一个查询：

import oracledb

# 连接到数据库
connection = oracledb.connect(
    user="your_username",
    password="your_password",
    dsn="your_dsn"
)

# 创建游标
cursor = connection.cursor()

# 执行查询
cursor.execute("SELECT * FROM your_table")

# 获取结果
for row in cursor:
    print(row)

# 关闭游标和连接
cursor.close()
connection.close()

使用 Thin 模式和 Thick 模式

python-oracledb 支持两种模式：

Thin 模式：默认模式，直接连接到 Oracle 数据库，无需 Oracle 客户端库。

Thick 模式：需要 Oracle 客户端库，支持更多高级功能。

要启用 Thick 模式，请确保安装了 Oracle 客户端库，并在代码中设置 thick_mode：

import oracledb

oracledb.init_oracle_client(lib_dir="/path/to/instantclient_19_8")

connection = oracledb.connect(
    user="your_username",
    password="your_password",
    dsn="your_dsn",
    thick_mode=True
)