非默认Schema下存在的表为何报‘relation does not exist’错误？

这个报错的核心原因是SQLAlchemy没有正确识别你要操作的表所属的非默认schema，下面给你拆解原因和对应的解决办法：

为什么会报错？ #

你当前的代码里把omni.all_order直接作为表名传给Table构造函数，但SQLAlchemy并不会自动解析这个字符串里的schema和表名——它会把整个omni.all_order当作一个完整的表名，去数据库的**默认schema（通常是public）**里找，自然找不到实际在omni schema下的all_order表。

解决办法（按推荐程度排序） #

1. 定义Table时显式指定schema参数

这是最清晰、最不易出错的方式，直接告诉SQLAlchemy表属于哪个schema：

engine = create_engine('postgresql+psycopg2:....', convert_unicode=True)
metadata = sqlalchemy.MetaData()
table = sqlalchemy.Table(
    'all_order',  # 这里只写表名
    metadata,
    sqlalchemy.Column('o_id', sqlalchemy.Integer),
    sqlalchemy.Column('order', sqlalchemy.String),
    schema='omni'  # 显式指定schema
)
ins = table.insert().values(all_rows)
engine.execute(ins)

这样生成的SQL会明确指向omni.all_order，就能正确找到表了。

2. 配置连接时设置默认schema

如果你的大部分数据库操作都针对omni schema，可以在创建engine时把omni设为默认schema，这样后续定义表时就不用每次都写schema参数：

# 方式一：在连接字符串中添加options参数
engine = create_engine(
    'postgresql+psycopg2://user:password@host/dbname?options=-csearch_path=omni',
    convert_unicode=True
)

# 方式二：用connect_args传递参数（更清晰）
engine = create_engine(
    'postgresql+psycopg2:....',
    convert_unicode=True,
    connect_args={'options': '-csearch_path=omni'}
)

# 之后定义表直接写表名即可
table = sqlalchemy.Table('all_order', metadata,
    sqlalchemy.Column('o_id', sqlalchemy.Integer),
    sqlalchemy.Column('order', sqlalchemy.String),
)

这个设置会让PostgreSQL会话默认使用omni schema，所有未指定schema的表操作都会自动指向它。

3. 用带双引号的完整表名（兜底方案）

如果你的schema或表名包含特殊字符（比如大写、空格），可以用双引号包裹完整的标识符（PostgreSQL对大小写敏感的标识符需要双引号），不过你的场景里应该不需要，但可以作为应急方案：

table = sqlalchemy.Table(
    '"omni"."all_order"',  # 双引号包裹schema和表名
    metadata,
    sqlalchemy.Column('o_id', sqlalchemy.Integer),
    sqlalchemy.Column('order', sqlalchemy.String),
)

总结 #

优先选择前两种方法，显式指定schema（方案1）适合只操作少数非默认schema表的场景，设置默认schema（方案2）适合大部分操作都在同一个非默认schema下的场景，都能彻底解决你的问题。

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