Java通过SQLServerDataTable类模拟SQL Server表值参数（TVP），需使用6.4+版本mssql-jdbc驱动及SQL Server 2008+，先定义匹配UDT的列结构并填充数据，再用setStructured方法绑定到存储过程参数。
Java 本身没有直接对应 SQL Server 表值参数（Table-Valued Parameters, TVP）的内置类型，但可以通过 SQL Server JDBC 驱动支持的 SQLServerDataTable 类来模拟实现——这是微软官方 JDBC 驱动（mssql-jdbc）提供的专用机制，用于将 Java 数据结构批量传入 TVP 类型的存储过程参数中。
1. 前提：确认驱动版本和数据库支持
必须使用 Microsoft JDBC Driver for SQL Server 6.4 或更高版本（推荐最新稳定版，如 12.x），并确保目标 SQL Server 版本 ≥ 2008（TVP 自 2008 引入）。
- 在
pom.xml中引入正确驱动（避免使用过时的sqljdbc4）：
<groupId>com.microsoft.sqlserver</groupId>
<artifactId>mssql-jdbc</artifactId>
<version>12.6.1.jre11</version>
</dependency>
同时，数据库中需已定义好对应的用户定义表类型（UDT），例如：
CREATE TYPE dbo.OrderItemTableType AS TABLE (ProductId INT,
Quantity INT,
UnitPrice DECIMAL(18,2)
);
2. 构建 SQLServerDataTable 并填充数据
SQLServerDataTable 是一个内存中的表格结构，需先定义列名与类型，再逐行添加数据。注意列顺序、名称、类型必须与 UDT 完全一致（包括大小写不敏感但建议保持一致）。
立即学习“Java免费学习笔记（深入）”；
Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。 涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。 当用户需要：(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...
- 创建实例并定义 schema：
dataTable.addColumnMetadata("ProductId", java.sql.Types.INTEGER);
dataTable.addColumnMetadata("Quantity", java.sql.Types.INTEGER);
dataTable.addColumnMetadata("UnitPrice", java.sql.Types.DECIMAL);
- 插入多行数据（支持
null，对应 SQL 的NULL）：
dataTable.addRow(102, 3, BigDecimal.valueOf(19.50));
dataTable.addRow(103, null, BigDecimal.valueOf(9.99)); // Quantity 为 NULL
3. 在 PreparedStatement 中绑定 TVP 参数
调用存储过程时，使用 setStructured 方法绑定 SQLServerDataTable，参数名需与存储过程中声明的 TVP 参数名一致，类型名需与数据库中 UDT 名称完全匹配（含 schema）。
try (Connection conn = dataSource.getConnection();
CallableStatement stmt = conn.prepareCall(sql)) {
stmt.setInt(1, orderId); // 普通参数
stmt.setStructured(2, "dbo.OrderItemTableType", dataTable); // 绑定 TVP
stmt.execute();
}
⚠️ 注意：setStructured 是 Microsoft JDBC 特有方法，不能用标准 JDBC 的 setObject 替代；第二个参数是 UDT 的完整三段式名称（schema.typeName）。
4. 存储过程示例（供参考）
接收 TVP 的存储过程可像操作普通表一样使用 JOIN、INSERT INTO ... SELECT 等：
@OrderId INT,
@Items dbo.OrderItemTableType READONLY
AS
BEGIN
INSERT INTO OrderDetails (OrderId, ProductId, Quantity, UnitPrice)
SELECT @OrderId, ProductId, Quantity, UnitPrice FROM @Items;
END
这种方式真正实现了“一次网络往返 + 单次执行”完成批量插入，性能远优于循环执行单条 INSERT，也比临时表或字符串拼接更安全、类型更严谨。
