Flask Migrate迁移SQL Server时生成Varchar(Max)字段的问题咨询

问题描述 #

我在使用Flask进行数据库迁移时，定义了如下Model类：

class DocumentBc23(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    packing_list_id = db.Column(db.Integer, db.ForeignKey('packing_list.id'), nullable=False)
    nomorAju = db.Column(db.String, nullable=False)
    kodeDokumen = db.Column(db.String, nullable=True)
    kodeKantor = db.Column(db.String, nullable=False)
    kodeKantorBongkar = db.Column(db.String, nullable=False)
    kodeTujuanTpb = db.Column(db.String, nullable=False)
    kodeTutupPu = db.Column(db.String, nullable=True)
    nomorBc11 = db.Column(db.String, nullable=False)
    tanggalBc11 = db.Column(db.Date, nullable=False)

但在SQL Server中，所有String类型字段均被创建为Varchar(Max)。此前并未出现该情况，程序从旧服务器迁移至新服务器后问题出现，怀疑与服务器迁移有关，请问需要进行哪些设置才能避免字段大小变为Max？

解决方法 #

1. 显式指定String字段长度 #

Flask-SQLAlchemy中，db.String未指定长度时，SQL Server驱动在部分配置下会默认映射为Varchar(Max)。直接在字段定义时添加长度参数，根据业务需求设置合适值：

nomorAju = db.Column(db.String(255), nullable=False)
kodeDokumen = db.Column(db.String(50), nullable=True)
kodeKantor = db.Column(db.String(30), nullable=False)
# 其余字段同理配置对应长度

2. 检查SQL Server连接字符串配置 #

新服务器上的连接字符串可能存在差异，导致字段类型生成逻辑改变。确保连接字符串使用标准格式，避免包含影响字段类型的特殊参数：

app.config['SQLALCHEMY_DATABASE_URI'] = 'mssql+pyodbc://用户名:密码@服务器地址/数据库名?driver=ODBC+Driver+17+for+SQL+Server'

同时确认新服务器安装的ODBC驱动版本与旧服务器一致，版本差异可能导致类型映射不同。

3. 全局设置SQLAlchemy默认字符串长度 #

若不想逐个字段指定长度，可全局配置SQLAlchemy的默认字符串长度：

from sqlalchemy.sql.sqltypes import String
# 设置默认长度为255，可根据实际调整
String.DEFAULT_LENGTH = 255

配置后，未指定长度的db.String字段会自动使用该长度生成对应SQL Server字段类型。

4. 检查Alembic迁移脚本配置 #

如果使用Alembic做数据库迁移，重新生成迁移脚本时，确认脚本中字段类型为指定长度的Varchar而非Varchar(Max)。若已有迁移脚本存在错误，可手动修改脚本中的字段类型定义，再执行迁移。

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