如何在SQLAlchemy ORM与SQLite中设置ON CONFLICT表约束？

嘿，我来帮你搞定这个问题！要在SQLAlchemy ORM里给SQLite表定义带ON CONFLICT策略的唯一约束，其实有两种常用方式，而且确实要注意和MySQL的插入逻辑区分开——你说得没错，INSERT…ON DUPLICATE KEY UPDATE是操作层面的逻辑，而我们现在要做的是表结构定义的约束。

方法一：用ORM模型的UniqueConstraint（推荐） #

SQLAlchemy针对SQLite提供了sqlite_on_conflict扩展参数，让你可以在定义UniqueConstraint时直接指定冲突处理策略，完全贴合你的需求。

示例代码如下：

from sqlalchemy import Column, Integer, String, UniqueConstraint
from sqlalchemy.ext.declarative import declarative_base
from sqlalchemy import create_engine
from sqlalchemy.orm import sessionmaker

Base = declarative_base()

class Tbl(Base):
    __tablename__ = 'tbl'
    # 建议添加主键字段（SQLite允许无主键，但主键能让表结构更规范）
    id = Column(Integer, primary_key=True, autoincrement=True)
    fld = Column(String, nullable=False)
    
    # 定义带冲突处理的唯一约束
    __table_args__ = (
        # 当fld字段出现重复时，执行REPLACE策略（替换现有行）
        UniqueConstraint('fld', sqlite_on_conflict='REPLACE'),
        # 如果需要IGNORE策略（忽略冲突行），直接改成sqlite_on_conflict='IGNORE'即可
    )

# 创建数据库引擎并生成表结构
engine = create_engine('sqlite:///test.db')
Base.metadata.create_all(engine)

# 测试约束效果
Session = sessionmaker(bind=engine)
session = Session()

# 插入第一条数据
session.add(Tbl(fld="demo_value"))
session.commit()

# 插入重复数据，此时会触发REPLACE，原行会被新数据替换
session.add(Tbl(fld="demo_value"))
session.commit()

# 验证结果：只会保留1条记录
print(session.query(Tbl).count())  # 输出：1

方法二：执行原生SQL DDL创建表 #

如果你更习惯用原生SQL来定义表结构，也可以直接执行CREATE TABLE语句：

from sqlalchemy import create_engine

engine = create_engine('sqlite:///test.db')
with engine.connect() as conn:
    # 执行原生SQL创建带ON CONFLICT约束的表
    conn.execute("""
        CREATE TABLE tbl (
            fld TEXT UNIQUE,
            UNIQUE(fld) ON CONFLICT IGNORE
        )
    """)
    conn.commit()

关键注意点 #

• 这种约束是表级别的，一旦定义完成，所有针对该表的插入/更新操作触发唯一冲突时，SQLite都会自动执行指定的策略（REPLACE/IGNORE），不需要在每次操作时额外编写逻辑。
• 和MySQL的INSERT…ON DUPLICATE KEY UPDATE的核心区别：后者是在插入操作时指定的临时逻辑，属于操作层面；而我们这里的约束是表结构的一部分，属于Schema定义层面，作用范围覆盖所有对该表的写操作。

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