python-oracledb 已率先支持 Oracle 23ai

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 的如下特性：

1. 支持 VECTOR 数据类型。
2. 支持隐式连接池，DRCP （数据库驻留连接池） 和 PRCP （代理驻留连接池），通过新参数 pool_boundary 启用。
3. 为从 OCI 云网络连接到 Oracle Autonomous Database Serverless (ADB-S) 的应用程序添加了对 TCP Fast Open 的支持，通过新的 use_tcp_fast_open 参数启用。
4. 增加了 oracledb.JsonId 类，以表示存储在本机集合中的文档的 _id 属性中由 SODA 返回的 JSON ID 值。
5. 增加了对 23ai JSON 功能的支持，并允许字段名称具有超过 255 个 UTF-8 编码字节。
6. 增加了 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 数据库。

代码基本流程如下：

1. 引入 oracledb 包
2. 创建独立连接
3. 分别查看客户端和服务器端版本
4. 创建测试表，其中一列的数据类型为向量
5. 插入测试数据
6. 查询测试表数据

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『转发』吧，感谢！(๑˃̵ᴗ˂̵)