SQLAlchemy中能否创建无主键表？适配远程无主键表的测试需求

数据老陈

2026-7-10

解决方法

1. 用SQLAlchemy Core定义表（推荐，完全匹配原表结构）

SQLAlchemy Core不强制要求表必须有主键，可完整复刻远程无主键表的结构，适配仅查询测试的场景：

from sqlalchemy import MetaData, Table, Column
from sqlalchemy.dialects.mssql import DATE, VARCHAR, TINYINT

# 定义元数据
metadata = MetaData()

# 复刻远程表结构，无需主键定义
my_table = Table(
    'my_table',
    metadata,
    Column('col1', DATE(), nullable=False),
    Column('col2', VARCHAR(length=15), nullable=False),
    Column('col3', TINYINT(), nullable=False),
)

# 初始化SQLite引擎并创建测试表
from sqlalchemy import create_engine
engine = create_engine('sqlite:///test.db')
metadata.create_all(engine)

此方式创建的表与远程结构完全一致，SQLite允许无主键表，且Core的查询操作与ORM兼容，可直接用于测试。

2. 用ORM但指定虚拟主键

若必须使用declarative_base风格的ORM，可选择业务上唯一的列组合作为虚拟主键（仅满足ORM要求，不影响原表结构）：

from sqlalchemy import Column
from sqlalchemy.ext.declarative import declarative_base
from sqlalchemy.dialects.mssql import DATE, VARCHAR, TINYINT

Base = declarative_base()

class MyTable(Base):
    __tablename__ = 'my_table'

    # 用col1+col2作为复合虚拟主键，满足ORM映射要求
    col1 = Column('col1', DATE(), nullable=False, primary_key=True)
    col2 = Column('col2', VARCHAR(length=15), nullable=False, primary_key=True)
    col3 = Column('col3', TINYINT(), nullable=False)

若没有业务唯一列，也可添加仅在测试库生效的虚拟自增主键：

from sqlalchemy import Column, Integer

class MyTable(Base):
    __tablename__ = 'my_table'

    # 虚拟自增主键，仅用于ORM映射
    id = Column(Integer, primary_key=True, autoincrement=True)
    col1 = Column('col1', DATE(), nullable=False)
    col2 = Column('col2', VARCHAR(length=15), nullable=False)
    col3 = Column('col3', TINYINT(), nullable=False)

注：此方式仅适合查询测试，不要用ORM执行远程表的更新/删除操作（远程无主键，ORM无法定位行）。

3. 自动生成表定义代码（避免手动编写错误）

针对大量表的场景，可使用sqlacodegen工具直接从远程数据库生成SQLAlchemy代码，无主键表也能正确识别：
首先安装工具：

pip install sqlacodegen

执行命令生成Core风格的表定义：

sqlacodegen mssql+pyodbc://my_server/my_database?trusted_connection=yes&driver=my_driver --schema my_schema --outfile models.py

生成的代码可直接用于在SQLite中创建测试表，完全匹配远程表结构。

注意事项

Core定义的表，测试查询逻辑与远程表的SQLAlchemy操作完全兼容，无需修改代码；
跨数据库类型适配：MSSQL部分类型在SQLite中会自动兼容（如VARCHAR映射为TEXT），若需严格匹配，可通过SQLAlchemy方言类型切换实现。

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