使用SQLAlchemy/FreeTDS长字符串比较时遇varchar(max)与ntext不兼容错误

相关环境配置 #

先给大家列一下当前的环境参数：

• FreeTDS编译配置（通过configure脚本设置）：
  • 版本：v0.95.81
  • freetds.conf目录：/etc
  • MS db-lib源码兼容性：是
  • Sybase二进制兼容性：是
  • 线程安全：是
  • iconv库：是
  • TDS版本：4.2
  • iODBC：否
  • unixODBC：是
  • SSPI“可信”登录：否
  • Kerberos：是
  • OpenSSL：否
  • GnuTLS：是
• SQLAlchemy版本：1.1.13
• 目标数据库：MS SQL Server 2008

问题场景与错误提示 #

在执行包含长字符串比较的SQL操作时，触发错误提示：varchar(max) and ntext are incompatible = to operator

问题原因与解决方法 #

这个问题的核心原因很明确：你当前配置的TDS版本太低了！TDS 4.2是适配非常老旧SQL Server版本的协议，而SQL Server 2008已经支持更高版本的TDS，低版本协议会把varchar(max)这类现代大文本类型错误识别为ntext，自然就会出现类型不兼容的比较错误。

下面是具体的解决步骤：

1. 修改FreeTDS全局配置文件 #

编辑/etc/freetds.conf这个配置文件：

• 如果有针对目标SQL Server的单独连接配置段（比如[your_sql_server]），在里面把tds version从4.2改成7.2（7.2是完美兼容SQL Server 2008的版本），示例配置如下：

[your_sql_server]
        host = 你的SQL服务器地址
        port = 1433
        tds version = 7.2
        client charset = UTF-8

• 如果没有单独的连接段，直接修改全局的[global]部分的tds version设置即可。

2. 验证配置是否生效 #

修改完配置后，用tsql -C命令查看当前FreeTDS的配置信息，确认tds version已经更新为7.2：

tsql -C

输出内容里应该能看到tds version: 7.2的条目。

3. （可选）在SQLAlchemy连接中直接指定TDS版本 #

如果不想改动全局配置，也可以在SQLAlchemy的连接URL里直接指定TDS版本，这样只对当前应用生效，示例代码如下：

from sqlalchemy import create_engine
# 替换成你的实际连接信息
engine = create_engine('mssql+pyodbc://用户名:密码@服务器地址/数据库名?driver=FreeTDS&tds_version=7.2')

额外说明 #

TDS 7.2及以上版本完全支持SQL Server 2005及以后的新数据类型（比如varchar(max)、nvarchar(max)），调整版本后，FreeTDS就能正确识别这些类型，长字符串的比较操作也就不会再触发那个兼容性错误了。

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