tvp比拼接sql或循环insert快得多，因其底层采用二进制协议传输，绕过sql解析、编译及执行计划重编译开销；万级数据下性能可达拼接sql的5–10倍、逐条insert的百倍以上，但需严格匹配udt结构（列序、类型、大小写、null处理）并正确设置typename，否则易因隐式转换或绑定失败导致性能骤降甚至报错。
为什么TVP比拼接SQL或循环INSERT快得多
TVP底层走的是二进制协议传输，SQL Server直接把整个表结构数据当参数传进来，绕过了SQL解析、编译、执行计划重编译这些开销。对比INSERT ... VALUES (...),(...)拼接方式，TVP在万级行以上基本稳压5–10倍性能；比逐条INSERT更是快两个数量级。但前提是必须用DataTable或SqlDbType.Structured正确构造，否则反而更慢。
常见错误现象：
- 传入DataTable后执行超时，实际是列名/类型没对齐，SQL Server内部做了隐式转换甚至全表扫描
- INSERT INTO target SELECT * FROM @tvp报错“无法绑定多部分标识符”，其实是TVP没声明或作用域不对
- C#里用new SqlParameter("@tvp", SqlDbType.Structured)但忘了设.TypeName，直接抛InvalidOperationException
如何在C#中正确构造DataTable并绑定TVP
关键不是“能跑”，而是“不踩坑”。TVP要求DataTable的列顺序、名称、类型、是否允许NULL，必须和数据库里定义的用户定义表类型（UDT）完全一致——连大小写都要一致（SQL Server默认区分）。
实操建议：
- 先在SQL Server里建好UDT：
CREATE TYPE dbo.OrderItemTVP AS TABLE (OrderId INT NOT NULL, ProductId INT NOT NULL, Qty INT NOT NULL);
- C#里创建
DataTable时，列顺序必须严格按UDT定义顺序；用dt.Columns.Add("OrderId", typeof(int))，别用dt.Columns.Add(new DataColumn("OrderId", typeof(int)))——后者不保证顺序 -
SqlParameter必须同时设置：.TypeName = "dbo.OrderItemTVP"（字符串要带schema）、.SqlDbType = SqlDbType.Structured、.Value = dataTable - 如果某列为
NULL，对应DataRow里必须设DBNull.Value，不能设null或default(int)
TVP在SQL里怎么安全高效地用
TVP本质是只读表变量，不能UPDATE或DELETE，但可以JOIN、EXISTS、IN。最常用也最安全的写法就是INSERT ... SELECT，但要注意执行计划是否真的用了索引。
使用场景与陷阱：
- 批量插入前需校验：用
IF NOT EXISTS (SELECT 1 FROM @tvp WHERE OrderId ，别在C#里做校验——TVP传过来就该干净 - 避免
SELECT * FROM @tvp——显式写出列名，防止UDT后续加列导致目标表插入错位 - 如果目标表有自增主键，TVP里别传值；如果有唯一约束，TVP本身不校验，得靠SQL Server报
Violation of UNIQUE KEY错误 - 大批次（>10万行）建议分批调用，单次TVP超过20MB可能触发网络缓冲区问题，不是语法限制而是TCP层表现
为什么有时候TVP反而变慢了
不是TVP不行，是用错了地方。典型情况：UDT定义了10列，但你只填其中2列，其余全NULL；或者C#里DataTable用了string类型去塞datetime2字段，触发了全表隐式转换。
排查方向：
- 查执行计划：看
@tvp是不是被当成“远程查询”而非“表变量”，说明TypeName没设对 - 用
SET STATISTICS IO ON对比TVP和普通INSERT的逻辑读——如果TVP的读取数高一个量级，大概率是列类型不匹配 - 检查SQL Server错误日志，找
Could not find type 'xxx' in assembly类报错，说明UDT没在目标库创建，或.TypeName拼写错误 - 别在存储过程中对TVP再做
INSERT INTO #temp SELECT * FROM @tvp——多一次拷贝，纯属浪费
TVP真正发力的地方，是“已知结构+大批量+低延迟”场景。一旦涉及动态列、混合类型或需要中间计算，不如退回临时表或SqlBulkCopy。它不是万能加速器，而是一把精准手术刀——用对了快得离谱，用歪了比手写INSERT还慢。
