PostgreSQL中SQLAlchemy映射xmin字段的正确类型是什么？

问题根源 #

PostgreSQL的xmin是xid类型，本质是无符号32位整数。你之前用Integer映射时，因为SQLAlchemy的Integer是有符号32位，当xmin值超过2^31-1（即2147483647）时，就会触发数值溢出错误；用String会因类型不匹配，无法直接和xid做相等比较；BigInteger则会因为类型转换逻辑不匹配，同样引发错误。

正确解决方案 #

使用SQLAlchemy为PostgreSQL提供的专属XID类型，它会完美适配数据库的xid类型：

1. 模型映射代码：

from sqlalchemy.dialects.postgresql import XID
from sqlalchemy.orm import mapped_column, Base

class MyTable(Base):
    version = mapped_column(XID, name="xmin", system=True)

2. 更新语句无需手动转换类型，直接比较即可：

update(MyTable).where(MyTable.version == row.version)

为什么这个方案可行 #

XID类型是SQLAlchemy专门为PostgreSQL的xid类型设计的映射类型，它会自动处理数据库端的类型匹配和转换逻辑，既不会出现数值溢出，也能支持正常的相等比较操作，完全适配乐观锁场景下的xmin使用需求。

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