PostgreSQL使用tds_fdw创建外部表时大文本被截断为2048字符问题

核心原因 #

2048字符截断问题是tds_fdw及底层FreeTDS协议的默认配置限制导致的，常见触发原因有三类：

• TDS协议版本配置过低：低于7.2版本的TDS协议默认对大文本类型的返回长度限制为2048字节，无法完整读取nvarchar(max)类型的长文本
• text_size参数默认值限制：tds_fdw默认的text_size参数值为2048，超过该长度的文本会被直接截断
• 外部表关联的服务实例不匹配：你提供的配置中，创建的服务实例名为mssql_srv，但创建外部表时指定的SERVER参数为vsql_tx，如果是真实配置而非笔误，服务级别的修改不会生效到该外部表

排查与配置调整步骤 #

1. 优先修正外部表关联的服务实例（如果是配置错误）

ALTER FOREIGN TABLE my_large_table SERVER mssql_srv;

2. 调整tds_fdw服务级别的配置，指定高版本TDS协议和足够的文本长度上限

ALTER SERVER mssql_srv 
OPTIONS (
  ADD tds_version '7.4',
  ADD text_size '1048576'
);
-- 如果参数已存在，将ADD替换为SET即可

text_size可按需调整，单位为字节，上述配置设置为1MB，足够覆盖20~30KB的文本场景；TDS 7.4版本兼容SQL Server 2014及以上版本，支持完整读取大对象类型。
3. 检查FreeTDS全局配置
打开/etc/freetds/freetds.conf文件，确认全局配置或者对应mssql_srv实例的配置段中参数符合要求：

[global]
    tds version = 7.4
    text size = 1048576

修改配置后重启PostgreSQL服务生效。

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