如何在T-SQL函数中仅当参数非空时添加INNER JOIN

你的示例代码存在语法问题，比如函数定义不完整、IF语句不能直接嵌入查询流程、STRING_SPLIT语法错误，且T-SQL不支持在查询中间动态增减JOIN子句。要实现仅当@FrequencyFilter非空且不为空字符串时才应用INNER JOIN的需求，且不使用外连接，有两种可靠的实现方式：

方法1：用UNION ALL拆分场景 #

这种方式把参数为空/非空的情况拆成两个独立查询，通过UNION ALL合并结果，SQL Server会根据参数值自动执行对应分支，完全避免无效JOIN操作：

CREATE FUNCTION [dbo].[MyFunction]
(
    @FrequencyFilter VARCHAR(10)    -- 示例值 '6;1;4'
)
RETURNS TABLE
AS
RETURN
(
    -- 场景1：参数为空或空字符串，不添加筛选JOIN
    SELECT T1.field1, T1.field2, T1.field3
    FROM Table1 AS T1
    JOIN Table2 AS T2 ON T2.id = T1.t2Id
    WHERE T1.field4 = 'test'
      AND (@FrequencyFilter IS NULL OR @FrequencyFilter = '')

    UNION ALL

    -- 场景2：参数非空，添加STRING_SPLIT的INNER JOIN筛选
    SELECT T1.field1, T1.field2, T1.field3
    FROM Table1 AS T1
    JOIN Table2 AS T2 ON T2.id = T1.t2Id
    INNER JOIN STRING_SPLIT(@FrequencyFilter, ';') AS FF 
        ON FF.Value = T1.frequency
    WHERE T1.field4 = 'test'
      AND @FrequencyFilter IS NOT NULL AND @FrequencyFilter <> ''
)

这种方法逻辑直观，无需动态SQL，SQL Server能生成针对性的执行计划，性能稳定。如果需要去重结果，可将UNION ALL换成UNION，但会带来额外性能开销，需根据业务场景选择。

方法2：用动态SQL（适配复杂场景） #

如果查询逻辑更复杂，需要动态调整更多子句，可以用动态SQL拼接语句。注意必须使用多语句表值函数，且通过sp_executesql参数化传递参数避免注入风险：

CREATE FUNCTION [dbo].[MyFunction]
(
    @FrequencyFilter VARCHAR(10)
)
RETURNS @Result TABLE 
(
    field1 INT,    -- 替换为实际字段类型
    field2 VARCHAR(50),
    field3 DATETIME
)
AS
BEGIN
    DECLARE @SQL NVARCHAR(MAX)

    -- 基础查询语句
    SET @SQL = N'
        SELECT T1.field1, T1.field2, T1.field3
        FROM Table1 AS T1
        JOIN Table2 AS T2 ON T2.id = T1.t2Id
    '

    -- 仅当参数有效时，添加INNER JOIN
    IF @FrequencyFilter IS NOT NULL AND @FrequencyFilter <> ''
    BEGIN
        SET @SQL += N'
            INNER JOIN STRING_SPLIT(@FilterParam, '';'') AS FF 
                ON FF.Value = T1.frequency
        '
    END

    -- 添加WHERE条件
    SET @SQL += N'
        WHERE T1.field4 = ''test''
    '

    -- 执行动态SQL，参数化传递输入参数
    EXEC sp_executesql 
        @SQL, 
        N'@FilterParam VARCHAR(10)', 
        @FilterParam = @FrequencyFilter

    RETURN
END

额外说明 #

• 判断空字符串时，@FrequencyFilter <> ''和LEN(@FrequencyFilter) > 0效果一致，可任选其一。
• 动态SQL必须参数化传递用户输入，绝对不能直接拼接参数值，避免SQL注入风险。

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