使用SQLAlchemy+pyodbc查询SQL Server时提示'users'对象不存在

可能的原因及对应解决方案 #

1. 连接字符串数据库名拼写错误 #

检查连接字符串中的数据库名csdd-persistance是否与实际数据库名称完全一致（注意拼写细节：比如是否应为csdd-persistence）。如果名称不匹配，SQLAlchemy连接到了错误的数据库，自然找不到目标表。

修正示例：
若实际数据库名是csdd-persistence，连接字符串改为：

"mssql+pyodbc://localhost\MSSQLLocalDB/csdd-persistence?driver=ODBC+Driver+17+for+SQL+Server"

2. 模型的Schema配置未生效 #

虽然你在User模型中指定了__table_args__ = {"schema": "dbo"}，但可能存在以下问题：

• 父类BaseMSSQL的metadata设置了默认Schema，覆盖了子类的配置。检查BaseMSSQL的定义，确保其metadata没有硬编码其他Schema：

  class BaseMSSQL(Base):
      __abstract__ = True
      metadata = MetaData(schema=None)  # 确保这里未指定其他Schema
  

• SQLAlchemy未正确生成带Schema的SQL。可以开启SQLAlchemy的查询日志，验证生成的SQL是否包含dbo.users而非仅users。

3. 数据库用户默认Schema非dbo #

如果连接SQL Server的用户默认Schema不是dbo，查询时未指定Schema会自动去用户默认Schema查找表，导致找不到dbo.users。

验证与修正：

1. 执行SQL查询用户默认Schema：

   SELECT name, default_schema_name FROM sys.database_principals WHERE name = '你的数据库登录用户名';
   

2. 如果默认Schema不是dbo，执行修改语句：

   ALTER USER [你的用户名] WITH DEFAULT_SCHEMA = dbo;
   

4. 连接字符串未指定默认Schema #

在连接字符串中显式指定默认Schema，强制SQLAlchemy使用dbo进行查询：

"mssql+pyodbc://localhost\MSSQLLocalDB/csdd-persistance?driver=ODBC+Driver+17+for+SQL+Server&schema=dbo"

5. 迁移脚本未在dbo Schema下创建表 #

检查Alembic迁移脚本中的CREATE TABLE语句，确认是否包含dbo.前缀。如果迁移脚本生成的是CREATE TABLE users (...)而非CREATE TABLE dbo.users (...)，表会被创建在用户默认Schema下，而非dbo。

修正：
修改迁移脚本，在表名前添加dbo.前缀，或重新生成迁移脚本时确保Schema配置生效。

6. 数据库排序规则大小写敏感（罕见） #

如果数据库使用了大小写敏感的排序规则，模型中__tablename__ = "users"（小写）与实际表名（如Users）不匹配会导致错误。检查实际表名的大小写，统一模型与数据库的表名大小写即可。

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