python-oracledb 介绍
python-oracledb (以下简称 oracledb) 是 Python cx_Oracle 驱动程序的新名称。 oracledb 驱动程序是一个开源模块，使 Python 程序能够访问 Oracle 数据库。
该模块目前在 Python 3.7 到 3.12上，针对 Oracle 数据库 23ai, 21c, 19c, 18c, 12c 和 11gR2 进行了测试。
oracledb 最新版本为 2.2.0，以支持 23ai 的如下特性：
- 支持 VECTOR 数据类型。
- 支持隐式连接池，DRCP （数据库驻留连接池） 和 PRCP （代理驻留连接池），通过新参数
pool_boundary启用。 - 为从 OCI 云网络连接到 Oracle Autonomous Database Serverless (ADB-S) 的应用程序添加了对 TCP Fast Open 的支持，通过新的
use_tcp_fast_open参数启用。 - 增加了 oracledb.JsonId 类，以表示存储在本机集合中的文档的
_id属性中由 SODA 返回的 JSON ID 值。 - 增加了对 23ai JSON 功能的支持，并允许字段名称具有超过 255 个 UTF-8 编码字节。
- 增加了 SQL 域的属性
FetchInfo.domain_schema、FetchInfo.domain_name和FetchInfo.annotations以及与要获取的列关联的注释。
python-oracledb 安装
准备 Python 环境，这里使用的是 Python 3.9。
$ python --version
Python 3.9.18
然后，安装 pip 工具。
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
python get-pip.py
使用 pip 安装 python-oracledb 包。
$ pip install oracledb
...
Requirement already satisfied: cryptography>=3.2.1 in /usr/lib64/python3.9/site-packages (from oracledb) (36.0.1)
Requirement already satisfied: cffi>=1.12 in /usr/lib64/python3.9/site-packages (from cryptography>=3.2.1->oracledb) (1.14.5)
Requirement already satisfied: pycparser in /usr/lib/python3.9/site-packages (from cffi>=1.12->cryptography>=3.2.1->oracledb) (2.20)
Requirement already satisfied: ply==3.11 in /usr/lib/python3.9/site-packages (from pycparser->cffi>=1.12->cryptography>=3.2.1->oracledb) (3.11)
Installing collected packages: oracledb
Successfully installed oracledb-2.2.0
到此， oracledb 已经安装完成，可以看到这里安装的是最新版本 2.2.0。
使用 oracledb 连接 23ai
下面举个栗子，演示如何使用 oracledb 连接到 Oracle 23ai 数据库。
代码基本流程如下：
- 引入 oracledb 包
- 创建独立连接
- 分别查看客户端和服务器端版本
- 创建测试表，其中一列的数据类型为向量
- 插入测试数据
- 查询测试表数据
import oracledb
conn = oracledb.connect(dsn="SHAWNYAN/1@127.1:1521/FREEPDB1", mode=oracledb.AUTH_MODE_SYSDBA)
print("Client version: ", oracledb.__version__)
if conn.is_healthy():
print("Server version: ", conn.version)
else:
print("Unusable connection. Please check.")
cursor = conn.cursor()
create_vector_table = """
CREATE TABLE IF NOT EXISTS orders
(order_id INT, order_vector VECTOR)"""
cursor.execute(create_vector_table)
conn.commit()
insert_vector = "insert into orders values (1, '[1, 2]')"
cursor.execute(insert_vector)
conn.commit()
sql = "SELECT order_id, from_vector(order_vector) FROM ORDERS"
cursor.execute(sql)
result = cursor.fetchall()
for row in result:
print(row)
cursor.close()
conn.close()
print("See u.")
输出结果：
Client version: 2.2.0
Server version: 23.4.0.24.5
(1, '[1.0E+000,2.0E+000]')
See u.
小结
本文介绍了如何使用 python-oracle 连接 Oracle Database 23ai，并演示在代码中操作向量类型。
下一篇，将介绍两种隐式连接池的用法。
往期回顾
- 一文带你了解 Oracle 23ai 新特性 Vector 的基础用法
- Oracle 数据库全面升级为 23ai
- MySQL 8.4.0 LTS 发布 (MySQL 第一个长期支持版本)
– END –
如果这篇文章为你带来了灵感或启发，就请帮忙点『赞』or『在看』or『转发』吧，感谢！(๑˃̵ᴗ˂̵)
