U-SQL自定义表类型使用自定义UDT报错：AddOns.JsonObject无法作为列类型

看起来你遇到的问题是因为SQL Server对用作表类型列的用户定义类型（UDT）有严格的限制，不是随便标记SqlUserDefinedType就能直接用在表类型里的。我来帮你一步步解决：

错误原因 #

SQL Server要求，能作为表值类型列的UDT必须满足以下核心条件：

• 必须支持序列化/反序列化（要么实现IBinarySerialize接口，要么标记为ByteOrdered）
• 必须标记为[Serializable]
• UDT的MaxSize不能设置为-1（也就是不能是MAX长度的可变类型）
• 必须实现UDT要求的基础方法（比如Parse、ToString）

修正步骤 #

1. 调整自定义UDT的代码 #

首先修改你的JsonObject类，确保它符合SQL Server的要求：

namespace AddOns
{
    [Serializable]
    // 指定UserDefined格式，设置固定的MaxSize，这里用8000作为示例，根据你的JSON大小调整
    [SqlUserDefinedType(Format.UserDefined, TypeName = "AddOns.JsonObject", MaxSize = 8000, IsByteOrdered = false)]
    // 必须实现IBinarySerialize接口来处理序列化
    public class JsonObject : IBinarySerialize
    {
        public string Value { get; set; }

        // 实现IBinarySerialize的Read方法，从二进制读取数据
        public void Read(BinaryReader r)
        {
            Value = r.ReadString();
        }

        // 实现IBinarySerialize的Write方法，将数据写入二进制
        public void Write(BinaryWriter w)
        {
            w.Write(Value ?? string.Empty);
        }

        // 必须实现Parse方法，用于从SQL字符串转换为UDT
        public static JsonObject Parse(SqlString s)
        {
            if (s.IsNull) return null;
            return new JsonObject { Value = s.Value };
        }

        // 必须实现ToString方法，用于将UDT转换为SQL字符串
        public override string ToString()
        {
            return Value ?? string.Empty;
        }

        // 如果需要支持NULL，还要实现IsNull属性
        public bool IsNull { get; private set; }
        public static JsonObject Null => new JsonObject { IsNull = true };
    }
}

2. 重新部署程序集到SQL Server #

先卸载旧的程序集（如果之前已经部署过），再重新部署更新后的DLL：

-- 卸载旧程序集（如果存在）
DROP ASSEMBLY [AddOns];

-- 部署更新后的程序集，替换为你实际的DLL路径
CREATE ASSEMBLY [AddOns] 
FROM 'C:\Your\Path\To\AddOns.dll' 
WITH PERMISSION_SET = SAFE;

3. 创建表类型 #

现在你可以正常创建表类型了：

REFERENCE ASSEMBLY [AddOns]; 
CREATE TYPE Insight.dbo.JsonRow AS TABLE ( [Id] UNIQUEIDENTIFIER, [Value] AddOns.JsonObject ); 

额外提示 #

如果你的JSON内容可能超过8000字节，那表类型里无法使用这个UDT（因为表值参数不支持MAX长度的UDT）。这种情况下，更推荐直接用NVARCHAR(MAX)存储JSON，然后在需要的时候转换为你的JsonObject类型，或者直接使用SQL Server内置的JSON函数（比如JSON_VALUE、OPENJSON）来处理，这样更灵活也更符合SQL Server的原生支持。

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