使用SQLAlchemy从Sybase IQ反射MetaData对象时遇语法错误

问题场景 #

使用SQLAlchemy结合第三方方言sqlalchemy-sybase（基于SQLAlchemy 1.3中移除的Sybase方言）连接Sybase IQ数据库，执行元数据反射操作时触发语法错误。

执行代码 #

from sqlalchemy import create_engine, MetaData, Table

engine = create_engine(CONNECTION_URI)
metadata_obj = MetaData()
metadata_obj.reflect(bind=engine, schema="dbo")

错误信息 #

ProgrammingError: (pyodbc.ProgrammingError) ('42000', "[42000] [SAP][ODBC Driver][SAP IQ]Syntax error near 'precision' on line 6 (-131) (SQLPrepare)")

[SQL:
SELECT col.name AS name,
       t.name AS type,
       (col.status & 8) AS nullable, 
       (col.status & 128) AS autoincrement,
       com.text AS 'default',
       col.prec AS precision,
       col.scale AS scale,
       col.length AS length
FROM systypes 
t, syscolumns ]col LEFT OUTER JOIN syscomments com ON 
    col.cdefault = com.id
WHERE col.usertype = t.usertype
    AND col.id = ?
ORDER BY col.colid
]
[parameters: (3719922,)]

错误原因 #

1. 保留关键字冲突：precision是Sybase IQ的保留关键字，直接将其作为列别名会触发语法解析错误。
2. SQL语法错误：生成的SQL语句中出现syscolumns ]col的错误写法，多余的右括号导致SQL无法被正常解析。

解决方案 #

方案1：修改方言源码 #

找到sqlalchemy-sybase库中负责生成元数据查询的模块（通常为base.py或reflection.py），完成两处修改：

• 将col.prec AS precision改为col.prec AS "precision"（用双引号包裹保留关键字），或替换为非关键字别名如col_precision。
• 修复syscolumns ]col的错误写法，改为syscolumns col。

方案2：临时规避 #

如果不想修改源码，可尝试以下方式：

• 手动反射指定表：跳过自动生成全量反射的错误SQL，手动指定需要反射的表，示例：

  # 反射单个指定表
  target_table = Table('your_table_name', metadata_obj, autoload_with=engine, schema='dbo')
  

• 更换适配方言：改用专门针对Sybase IQ维护的SQLAlchemy方言，替代基于旧版Sybase方言的sqlalchemy-sybase。

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