如何在SQLAlchemy中使用Mapped[str]语法指定固定长度的字符串列类型？

嗨，我完全懂你的想法——MD5哈希的长度是固定的，给对应的数据库列指定固定长度确实是个很明智的优化，不管是存储空间还是查询性能都能受益。针对你用的SQLAlchemy 2.0版本的Mapped[str]语法，其实只需要在mapped_column里明确指定带长度参数的字符串类型就可以解决问题。

首先先明确MD5的两种常见存储形式：

• 十六进制字符串格式：这是最常用的形式，每个MD5哈希是32个字符长度的字符串
• 二进制格式：原始的128位哈希值，对应16字节的二进制数据

下面分别给出两种场景下的修改方案：

1. 存储十六进制格式的MD5（32字符） #

直接在mapped_column中使用String(32)来指定固定长度：

from sqlalchemy import String
from sqlalchemy.orm import Mapped, mapped_column

class HtmlData(MyBase):
    __tablename__ = 'html_data_table_name'

    html_id: Mapped[int] = mapped_column(primary_key=True)
    html_div: Mapped[str]
    html_div_md5: Mapped[str] = mapped_column(String(32))

这样运行create_all后，数据库会生成一个长度限制为32的字符串列（比如MySQL的varchar(32)，PostgreSQL的character varying(32)），完美匹配MD5十六进制字符串的长度。

2. 存储二进制格式的MD5（16字节） #

如果你想直接存储原始的二进制哈希值来进一步节省空间，可以用LargeBinary(16)，不过这种场景下更推荐用Mapped[bytes]来贴合二进制类型的映射：

from sqlalchemy import LargeBinary
from sqlalchemy.orm import Mapped, mapped_column

class HtmlData(MyBase):
    __tablename__ = 'html_data_table_name'

    html_id: Mapped[int] = mapped_column(primary_key=True)
    html_div: Mapped[str]
    html_div_md5: Mapped[bytes] = mapped_column(LargeBinary(16))

另外，如果你的数据库支持固定长度的字符类型（比如MySQL的CHAR、PostgreSQL的CHAR），也可以用CHAR(32)代替String(32)，这样数据库会使用固定长度的存储结构，对于MD5这种长度完全固定的字符串，性能表现会更稳定：

from sqlalchemy import CHAR
...
html_div_md5: Mapped[str] = mapped_column(CHAR(32))

修改完成后，重新运行create_all命令，对应的html_div_md5列就会变成固定长度的类型，完全符合你的优化需求啦。

备注：内容来源于stack exchange，提问作者user2138149