Flask-SQLAlchemy创建链接服务器表对象时SQL语法错误问题

问题根源 #

Flask-SQLAlchemy默认会对表名、架构名等标识符添加方括号转义，适配常规本地表的语法规则，但链接服务器的多部分名称（如sprod..sdba.collo）会被错误识别为单个标识符，导致生成的SQL语句包含无效的方括号格式，触发SQL Server的"无效对象名"错误。

可行解决方案 #

1. 直接指定未转义的表名

在模型类中使用text()包装完整的链接服务器表名，或者通过__table_args__禁用标识符转义：

from sqlalchemy import text
from flask_sqlalchemy import SQLAlchemy

db = SQLAlchemy()

# 方式1：用text()包装表名
class Collo(db.Model):
    __tablename__ = text('sprod..sdba.collo')
    id = db.Column(db.Integer, primary_key=True)
    # 定义其他字段...

# 方式2：禁用转义
class Collo(db.Model):
    __tablename__ = 'sprod..sdba.collo'
    __table_args__ = {'quote': False}
    id = db.Column(db.Integer, primary_key=True)

2. 自定义SQL Server方言的标识符处理逻辑

继承SQL Server的方言类，重写标识符预处理逻辑，识别链接服务器的多部分名称并跳过转义：

from sqlalchemy.dialects.mssql.base import MSIdentifierPreparer, SQLServerDialect
from flask_sqlalchemy import SQLAlchemy

db = SQLAlchemy()

class CustomMSIdentifierPreparer(MSIdentifierPreparer):
    def format_identifier(self, value):
        # 包含点号的多部分名称（链接服务器格式）直接返回原字符串
        if '.' in value:
            return value
        return super().format_identifier(value)

class CustomSQLServerDialect(SQLServerDialect):
    identifier_preparer = CustomMSIdentifierPreparer

# 在Flask配置中指定自定义方言
app.config['SQLALCHEMY_DATABASE_URI'] = 'mssql+pyodbc://<用户名>:<密码>@<ODBC数据源名>?driver=ODBC+Driver+17+for+SQL+Server'
app.config['SQLALCHEMY_ENGINE_OPTIONS'] = {
    'dialect': CustomSQLServerDialect
}

3. 使用原生SQL查询

如果模型映射的方式过于繁琐，直接通过SQLAlchemy的会话执行原生SQL，完全绕过自动生成逻辑：

from sqlalchemy import text

# 执行查询
result = db.session.execute(text("SELECT * FROM sprod..sdba.collo WHERE id = :id"), {'id': 1})
# 获取结果
rows = result.fetchall()

内容的提问来源于stack exchange，提问作者Theo Kromhout van der Meer