sqlalchemy 唯一约束 VS 索引(unique=True)

我正在使用 MySQL（运行 InnoDB），并使用 sqlalchemy 包装整个内容。现在，我想使用（请参阅docs http://sqlalchemy-utils.readthedocs.io/en/latest/database_helpers.html)

sqlalchemy_utils.functions.create_database(...)

一般来说，上面的函数会完成它应该做的事情。唯一的例外是唯一索引的生成。

比如说，我定义了一个这样的表：

## ...
# DeclBase = declarative_base()
## ...
class MyTable(DeclBase):
    __tablename__ = 'my_table'

    id = Column(Integer, primary_key=True)
    attr_1 = Column(String(32))
    attr_2 = Column(Integer, nullable=False)
    attr_3 = Column(DateTime)
    attr_4 = Column(
        Integer,
        ForeignKey('other_table.id', onupdate='CASCADE', ondelete='CASCADE'),
        nullable=False
    )

    u_idx = UniqueConstraint(attr_2, attr_3, 'my_table_uidx')

当我调用 create_database 时，我将让 sqlalchemy 创建包含指定所有列的表“my_table”。外键也设置得很好，但是在数据库端找不到唯一索引。然后我尝试使用 Index(unique=True) 代替。所以而不是

u_idx = UniqueConstraint(attr_2, attr_3, 'my_table_uidx')

I put

u_idx_1 = Index('my_table_uidx', attr_2, attr_3, unique=True)

我的印象是，这在逻辑上会产生类似的结果。这次 sqlalchemy 确实在数据库上创建了唯一索引。

也许我严重误解了 UniqueConstraint 和 Index(unique=True) 之间的区别，或者 sqlalchemy 使用它们自动生成数据库的方式。

有人能解释一下吗？

主要区别在于，虽然Index API http://docs.sqlalchemy.org/en/latest/core/constraints.html#index-api允许在表定义之外定义索引，只要它可以通过传递的 SQL 结构引用该表即可UniqueConstraint http://docs.sqlalchemy.org/en/latest/core/constraints.html#unique-constraint和一般限制必须在表定义中内联定义 http://docs.sqlalchemy.org/en/latest/core/constraints.html#setting-up-constraints-when-using-the-declarative-orm-extension:

应用表级约束对象，例如ForeignKeyConstraint对于使用声明式定义的表，请使用__table_args__属性，描述于表配置 http://docs.sqlalchemy.org/en/latest/orm/extensions/declarative/table_config.html#declarative-table-args.

需要理解的是，在构造声明类的过程中，一个新的Table被构造，如果没有传递显式的__table__。在您的示例模型类中UniqueConstraint实例绑定到类属性，但声明性基础不包括创建的约束Table来自属性的实例。您必须在表参数中传递它：

class MyTable(DeclBase):
    __tablename__ = 'my_table'
    ...
    # A positional argument tuple, passed to Table constructor
    __table_args__ = (
        UniqueConstraint(attr_2, attr_3, name='my_table_uidx'),
    )

请注意，您必须将约束名称作为关键字参数传递。您还可以使用传递约束Table.append_constraint() http://docs.sqlalchemy.org/en/latest/core/metadata.html#sqlalchemy.schema.Table.append_constraint，如果在尝试创建表之前调用：

class MyTable(DeclBase):
    ...

MyTable.__table__.append_constraint(
    UniqueConstraint('attr_2', 'attr_3', name='my_table_uidx'))