在 SQLAlchemy 2.0+ 中连接 Oracle 数据库时，使用 Table(..., autoload_with=engine) 反射表常因大小写不匹配报 NoSuchTableError；根本原因是 Oracle 默认将未加引号的标识符转为大写，而 SQLAlchemy 反射逻辑默认按小写名称查找，需显式统一命名约定。
在 sqlalchemy 2.0+ 中连接 oracle 数据库时，使用 `table(..., autoload_with=engine)` 反射表常因大小写不匹配报 `nosuchtableerror`；根本原因是 oracle 默认将未加引号的标识符转为大写，而 sqlalchemy 反射逻辑默认按小写名称查找，需显式统一命名约定。
Oracle 数据库对对象名称（如表名、列名）的大小写处理具有特殊性：若建表时未用双引号（"TableName"）定义，则 Oracle 自动将名称转为大写并以大写形式存储于数据字典中（如 ALL_TABLES.TABLE_NAME）。而 SQLAlchemy 2.0 的反射机制（尤其是 autoload_with 和 reflect_table）在生成元数据查询时，默认以小写形式拼接表名进行匹配，导致即使表真实存在，也无法在 ALL_TAB_COLS 或 ALL_TABLES 中查到对应记录，最终抛出 sqlalchemy.exc.NoSuchTableError: name。
✅ 正确做法：始终使用小写表名（推荐）
Oracle 数据字典视图（如 ALL_TAB_COLS）返回的 TABLE_NAME 字段值为大写，但 SQLAlchemy 内部反射逻辑要求传入的 name 参数为小写，以便其底层适配器正确执行大小写归一化匹配。因此，无论 Oracle 中表名实际如何定义（EMPLOYEES、employees 或 "Employees"），只要建表时未使用双引号，都应以小写字符串传入：
from sqlalchemy import create_engine, MetaData, Table
engine = create_engine(
f"oracle+oracledb://{user}:{password}@{dsn}",
echo=True # 推荐开启调试，观察实际执行的反射 SQL
)
meta = MetaData()
# ✅ 关键：name 参数必须为小写（即使数据库中显示为大写）
table = Table("employees", meta, schema="hr", autoload_with=engine)
# 验证反射结果
print(f"Columns: {[c.name for c in table.columns]}")
print(f"Primary key: {[c.name for c in table.primary_key.columns]}")
? 提示：可通过 engine.execute(text("SELECT TABLE_NAME FROM ALL_TABLES WHERE OWNER = 'HR'")) 手动确认目标表在数据字典中的确切大写名称，再将其转为小写传入。
⚠️ 其他注意事项
- Schema 名称同样需小写：schema="hr" 中的 "hr" 也应为小写（Oracle 用户/模式名默认大写，但 SQLAlchemy 要求小写传参）；
- 避免双引号建表：若建表语句为 CREATE TABLE "Employees" (...)，则该表名区分大小写且必须严格按 "Employees" 引用——此时反射需传 Table('"Employees"', ...)，但强烈建议避免此模式，以降低维护复杂度；
-
使用 inspect() 时同理：
from sqlalchemy import inspect insp = inspect(engine) table = Table("departments", MetaData()) # 小写表名 insp.reflect_table(table, schema="hr") # 小写 schema
? 总结
| 场景 | 推荐传入的 name 值 | 说明 |
|---|---|---|
| 表名为 EMPLOYEES（无引号创建） | "employees" | ✅ 最安全、最兼容 |
| 表名为 "Employees"（带引号创建） | '"Employees"' | ❌ 不推荐，易出错且破坏可移植性 |
简言之：在 SQLAlchemy 2.0+ 中反射 Oracle 表，唯一可靠的做法是始终将表名和 schema 名以小写字符串传入 Table() 或 reflect_table() —— 这是适配 Oracle 数据字典行为与 SQLAlchemy 反射协议的关键约定。
