SQLAlchemy：Oracle含复合主键表的反射与自动映射问题

首先给你吃个定心丸：SQLAlchemy的automap默认完全支持复合主键表的自动映射，你现在写的代码其实已经在处理这类表了——只要你的Oracle表的复合主键是正常定义的（比如通过PRIMARY KEY(col1, col2)这样的DDL创建），metadata.reflect()会正确识别这个复合主键约束，automap_base会自动生成带有复合主键属性的映射类，这些表会正常出现在Base.classes列表里。

如果你不确定复合主键是否被正确映射，可以随便挑一个复合主键表验证一下：

# 假设你的复合主键表叫order_items
order_items_cls = Base.classes.order_items
# 查看主键定义
print(order_items_cls.__table__.primary_key)

输出会显示包含多个列的主键对象，这就说明automap已经自动处理了复合主键，完全不需要手动额外配置（你看到的手动映射文档是针对特殊场景的，比如主键列名不符合automap的命名规则，或者需要自定义主键逻辑）。

接下来解决你提到的「仅显示有主键表」的问题：

SQLAlchemy的automap设计上就不会自动纳入无主键的表，这是因为ORM的核心要求是必须有唯一标识实体的主键，否则无法处理更新、删除等操作，也无法保证数据的一致性。如果一定要把无主键表加入automap，有两种实用方案：

方案1：反射后手动为无主键表指定主键 #

你可以在metadata.reflect()完成后，手动给无主键表添加主键定义，再执行automap的prepare操作：

from sqlalchemy import MetaData, create_engine
from sqlalchemy.ext.automap import automap_base

# 初始化引擎和元数据
engine = create_engine("oracle+cx_oracle://your_user:your_pass@your_host:your_port/your_service")
metadata = MetaData()
metadata.reflect(bind=engine, schema='USER')

# 处理无主键表：比如表名为`log_entries`，用Oracle内置的ROWID作为主键
log_table = metadata.tables['USER.log_entries']
# 把ROWID设为主键（Oracle的ROWID是每行唯一的标识符）
log_table.primary_key = log_table.c.ROWID

# 继续automap流程
Base = automap_base(metadata=metadata)
Base.prepare()
# 现在Base.classes里就会包含这个原本无主键的表
print(list(Base.classes))

如果你的表有某个天然唯一的列（比如唯一索引列），也可以把那个列设为主键，效果一样。

方案2：在automap基础上手动映射无主键表 #

如果不想修改元数据，你可以直接基于反射后的表创建手动映射类，继承自Base：

Base = automap_base(metadata=metadata)
Base.prepare()

# 手动映射无主键表
class LogEntries(Base):
    __table__ = metadata.tables['USER.log_entries']
    # 指定ROWID作为主键
    __mapper_args__ = {
        'primary_key': [metadata.tables['USER.log_entries'].c.ROWID]
    }

# 现在你可以直接用LogEntries类进行ORM操作
from sqlalchemy.orm import Session
session = Session(engine)
logs = session.query(LogEntries).limit(10).all()

最后再提醒一下：如果你的复合主键表没出现在Base.classes里，先检查两个点：

• 该表是否真的创建了复合主键约束（可以在Oracle里用DESCRIBE your_table或者查询USER_CONSTRAINTS视图确认）
• metadata.reflect()是否加载了该表（可以通过print(list(metadata.tables.keys()))查看所有反射到的表）

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