如何向表值参数传递多个值？当前需将单值传参扩展为列表

嘿，这个需求其实很容易实现，核心是先定义一个合适的表值参数类型，然后在函数里用它来匹配IN条件，我给你一步步讲清楚：

1. 先创建自定义表值参数类型 #

首先你需要创建一个专门的表类型，用来存储你要传递的多个值——本质上就是一个单列表，类型根据你实际的数据来定（比如int、varchar等）：

-- 示例：存储整数的表类型
CREATE TYPE dbo.IntValueList AS TABLE (Value INT NOT NULL);

-- 如果是字符串，就改成这样：
-- CREATE TYPE dbo.StringValueList AS TABLE (Value VARCHAR(100) NOT NULL);

2. 修改你的函数，接收这个表值参数 #

接下来调整你的函数，把原来的单个参数换成这个表值参数，注意要加上READONLY（函数里的表值参数必须是只读的），然后在WHERE IN子句里查询这个表的列：

CREATE OR ALTER FUNCTION dbo.GetTargetData (@FilterValues dbo.IntValueList READONLY)
RETURNS TABLE
AS
RETURN
(
    SELECT 
        Id, 
        Name, 
        Description
    FROM YourTargetTable
    -- 这里直接用表值参数里的Value列匹配IN条件
    WHERE Id IN (SELECT Value FROM @FilterValues)
);

3. 调用函数时传递多个值 #

现在调用的时候，你只需要把多个值插入到这个表类型的变量里，再传给函数就行，有几种常见的方式：

方式1：直接插入多个值 #

-- 声明表类型变量
DECLARE @InputValues dbo.IntValueList;
-- 插入多个你需要的值
INSERT INTO @InputValues (Value)
VALUES (101), (103), (107), (112);

-- 调用函数
SELECT * FROM dbo.GetTargetData(@InputValues);

方式2：从字符串拆分后插入（适合传入逗号分隔的列表） #

如果你的输入是逗号分隔的字符串（比如"101,103,107"），可以用STRING_SPLIT（SQL Server 2016及以上支持）来拆分后插入：

DECLARE @InputString VARCHAR(200) = '101,103,107,112';
DECLARE @InputValues dbo.IntValueList;

INSERT INTO @InputValues (Value)
SELECT CAST(value AS INT) 
FROM STRING_SPLIT(@InputString, ',');

SELECT * FROM dbo.GetTargetData(@InputValues);

一些额外提示 #

• 表值参数的类型要和你实际传递的数据严格匹配，比如不能用整数类型的表存字符串
• 这种方式比动态SQL拼接IN列表安全太多，完全避免SQL注入风险，而且查询优化器也能更好地处理执行计划
• 如果是在存储过程中使用表值参数，逻辑和函数基本一致，只是存储过程里的表值参数可以不用READONLY（但建议还是加上，避免意外修改）

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