oracledb厚模式下SDO_GEOMETRY转pickle字节输出转换器未调用问题

核心问题分析 #

厚模式下Oracle ADT（抽象数据类型，如SDO_GEOMETRY）的处理逻辑与薄模式存在差异：

• 直接在outputtypehandler中指定typ为bytes或DB_TYPE_RAW会触发ORA-00932错误，因为SDO_GEOMETRY是ADT而非二进制类型，类型不匹配。
• 厚模式下ADT不会自动触发outputtypehandler，必须先注册类型映射，让oracledb识别该ADT的结构，转换器才会生效。
• NUMBER列设bytes/DB_TYPE_RAW失败是因为NUMBER与RAW类型不兼容，不能直接强制转换，需先转字符串再编码为字节。

解决方案步骤 #

1. 注册SDO_GEOMETRY类型映射 #

厚模式连接后，需先获取SDO_GEOMETRY的类型元数据，再注册对应的转换逻辑：

import oracledb
import pickle

# 初始化厚模式
oracledb.init_oracle_client()

# 建立数据库连接
conn = oracledb.connect(user="你的用户名", password="你的密码", dsn="你的数据库DSN")

# 获取SDO_GEOMETRY类型元数据
sdo_type = conn.gettype("MDSYS.SDO_GEOMETRY")

# 定义SDO_GEOMETRY到pickle字节的转换函数
def sdo_to_pickle(sdo_obj):
    # 将SDO对象转为可序列化的字典
    sdo_data = {
        "SDO_GTYPE": sdo_obj.SDO_GTYPE,
        "SDO_SRID": sdo_obj.SDO_SRID,
        "SDO_POINT": sdo_obj.SDO_POINT,
        "SDO_ELEM_INFO": sdo_obj.SDO_ELEM_INFO,
        "SDO_ORDINATES": sdo_obj.SDO_ORDINATES
    }
    return pickle.dumps(sdo_data)

# 给SDO类型注册输出转换器
sdo_type.outputtypehandler = lambda value: sdo_to_pickle(value)

2. 处理NUMBER列的字节转换需求 #

对于NUMBER列，需在outputtypehandler中先将数值转为字符串再编码为字节，而非直接指定typ为bytes：

def output_type_handler(cursor, name, default_type, size, precision, scale):
    if default_type == oracledb.DB_TYPE_NUMBER:
        # 创建字符串类型变量，重写setvalue方法实现转字节逻辑
        var = cursor.var(str, size=size)
        var.setvalue = lambda pos, value: var._setvalue(pos, str(value).encode('utf-8'))
        return var
    # 其他类型沿用默认处理
    return None

# 给游标绑定全局outputtypehandler
cursor = conn.cursor()
cursor.outputtypehandler = output_type_handler

3. 完整查询示例 #

try:
    cursor.execute("SELECT id, geom FROM your_table WHERE id = :1", [1])
    row = cursor.fetchone()
    print("ID (字节格式):", row[0])
    print("SDO_GEOMETRY (Pickle字节):", row[1])
    
    # 验证Pickle反序列化
    unpickled_geom = pickle.loads(row[1])
    print("反序列化后的SDO数据:", unpickled_geom)
finally:
    cursor.close()
    conn.close()

关键说明 #

• 厚模式下ADT必须先通过conn.gettype()获取类型元数据，再注册outputtypehandler，否则转换器不会被触发。
• NUMBER转字节的核心是先转为字符串再编码，不能直接使用DB_TYPE_RAW，否则Oracle会尝试将NUMBER直接转为RAW二进制，导致类型不兼容。
• 若SDO_GEOMETRY的属性结构与示例不同，需调整sdo_to_pickle函数中的字段映射，确保覆盖所有属性。

内容的提问来源于stack exchange，提问作者Jannis