如何使用SQLAlchemy创建表并设置唯一索引忽略重复值？

首先需要明确：你提到的WITH (IGNORE_DUP_KEY = ON)是SQL Server的语法，MariaDB/MySQL并没有直接对应的索引属性。在MariaDB中，要实现插入重复唯一索引值时自动忽略，需要通过插入语句的特殊选项来实现，以下是针对你的代码的具体修改方案：

方案1：使用SQLAlchemy Core的INSERT IGNORE语句（推荐） #

这种方式直接对应MariaDB的INSERT IGNORE语法，当遇到唯一键冲突时会自动跳过该行，不会抛出异常，执行效率更高。

修改你的插入逻辑，替换ORM的add()/add_all()为Core的插入语句，并添加prefix_with('IGNORE')：

import datetime

# 假设你要插入的Pet数据列表
pets_to_insert = [
    Pet(name="旺财", weight=10.5, breed=1, birthday=datetime.datetime(2020, 1, 1)),
    Pet(name="来福", weight=8.2, breed=1, birthday=datetime.datetime(2020, 1, 1))  # 这行会触发唯一键冲突
]

# 使用Core的insert构造语句
from sqlalchemy import insert

insert_stmt = insert(Pet).prefix_with('IGNORE').values([
    {
        "name": pet.name,
        "weight": pet.weight,
        "breed": pet.breed,
        "birthday": pet.birthday
    } for pet in pets_to_insert
])

# 执行插入
session.execute(insert_stmt)
session.commit()

方案2：捕获ORM插入时的唯一键异常 #

如果你更倾向于使用ORM的add()/add_all()方法，可以捕获IntegrityError并跳过冲突的行：

import datetime
from sqlalchemy.exc import IntegrityError

pets_to_insert = [
    Pet(name="旺财", weight=10.5, breed=1, birthday=datetime.datetime(2020, 1, 1)),
    Pet(name="来福", weight=8.2, breed=1, birthday=datetime.datetime(2020, 1, 1))
]

for pet in pets_to_insert:
    try:
        session.add(pet)
        session.commit()
    except IntegrityError:
        session.rollback()
        # 可选：打印日志提示冲突
        print(f"跳过重复数据：{pet.name} (breed={pet.breed}, birthday={pet.birthday})")

补充说明 #

• 你的表结构定义不需要修改，现有的唯一索引breed_bd已经可以触发唯一键约束，只需要调整插入逻辑即可。
• 如果需要更精确的冲突控制（仅忽略唯一键冲突，不忽略其他数据错误），可以使用ON DUPLICATE KEY UPDATE并设置更新为原字段值（相当于忽略），示例：

insert_stmt = insert(Pet).values([...]).on_duplicate_key_update(
    name=Pet.name  # 保持原有字段值，不做实际更新
)

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