SQLAlchemy反射含BINARY_DOUBLE类型的Oracle数据库报错如何解决？

问题背景 #

你在使用SQLAlchemy 1.2.1反射Oracle数据库时，遇到了SAWarning: Did not recognize type 'BINARY_DOUBLE' of column 'column_1'的警告，并且尝试从sqlalchemy.dialects.oracle导入该类型时触发AttributeError。这是因为SQLAlchemy 1.2.x版本对Oracle的BINARY_DOUBLE类型支持存在两个问题：

1. 默认反射逻辑无法识别该类型
2. 该类型并未被导出到sqlalchemy.dialects.oracle模块的顶层，直接import *无法获取

解决方案 #

方案1：升级SQLAlchemy版本（推荐）

SQLAlchemy在1.3及以上版本中完善了Oracle类型的支持，BINARY_DOUBLE被直接导出到sqlalchemy.dialects.oracle模块，并且反射逻辑会自动识别该类型。升级后，你可以直接使用：

from sqlalchemy import create_engine, MetaData
from sqlalchemy.dialects.oracle import BINARY_DOUBLE

db_uri = 'oracle://USER:PASS@MYDBTNSNAME'
engine = create_engine(db_uri)
metadata = MetaData()
metadata.reflect(bind=engine)

此时警告和导入错误都会消失。

方案2：在1.2.1版本中手动处理类型映射

如果无法升级版本，可以通过以下方式手动注册类型，让SQLAlchemy识别BINARY_DOUBLE：

步骤1：导入正确的类型类

在1.2.1中，BINARY_DOUBLE的实现位于sqlalchemy.dialects.oracle.base模块下，需要直接导入：

from sqlalchemy.dialects.oracle.base import OracleBinaryDouble

步骤2：反射时指定类型映射

在调用metadata.reflect()时，通过type_map参数将数据库类型映射到对应的SQLAlchemy类型：

from sqlalchemy import create_engine, MetaData

db_uri = 'oracle://USER:PASS@MYDBTNSNAME'
engine = create_engine(db_uri)
metadata = MetaData()
# 手动映射BINARY_DOUBLE类型
metadata.reflect(bind=engine, type_map={'BINARY_DOUBLE': OracleBinaryDouble})

可选：全局注册类型映射

如果你需要在多个地方反射数据库，可以全局注册类型映射，避免重复指定：

from sqlalchemy import types
from sqlalchemy.dialects.oracle.base import OracleBinaryDouble

# 全局注册BINARY_DOUBLE类型
types.TypeEngine._type_map['BINARY_DOUBLE'] = OracleBinaryDouble

# 后续反射操作无需再指定type_map
metadata.reflect(bind=engine)

为什么之前的导入会失败？ #

在SQLAlchemy 1.2.1中，BINARY_DOUBLE（即OracleBinaryDouble）并没有被加入到sqlalchemy.dialects.oracle模块的导出列表中，因此from sqlalchemy.dialects.oracle import *无法获取到该类，必须从其所在的base子模块导入。

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