STRING_SPLIT不能直接当值用，必须用CROSS APPLY展开；它返回表值而非标量，需TRIM处理空格、过滤空值、确保兼容级别≥130，并用INSERT…SELECT批量插入。
STRING_SPLIT 不能直接当值用，必须用 CROSS APPLY 展开
很多人一上来就写 WHERE col = STRING_SPLIT(@tags, ',')，SQL Server 直接报错：“无法将表值函数用作标量”。STRING_SPLIT 返回的是单列表（value 列），不是单个值，它只能参与表连接或横向展开。
正确做法是用 CROSS APPLY 把拆分结果“拉进”主查询上下文：
SELECT p.id, p.title
FROM posts p
CROSS APPLY STRING_SPLIT(@TagList, ',') s
WHERE TRIM(s.value) IN (
SELECT TRIM(t.tag) FROM post_tags t WHERE t.post_id = p.id
);
- 不支持
INNER JOIN STRING_SPLIT(...)语法，必须用CROSS APPLY或OUTER APPLY -
s.value是NVARCHAR(4000)类型，若原始参数是NVARCHAR(MAX)，值超长会被截断，建议提前校验长度 - 若想保留原始顺序（比如第一个是主标签），
STRING_SPLIT在 2017 中不提供序号列，不能依赖ORDER BY s.value—— 那只是按字母排，不是按位置
空格、空值、连续分隔符必须显式过滤
传入 ' urgent ,high , ' 这种参数很常见，但 STRING_SPLIT 不会自动清理。直接比对会导致匹配失败，因为 ' urgent ' ≠ 'urgent'。
- 务必对
s.value用TRIM(s.value)，否则空格导致等值判断失效 - 连续分隔符如
'a,,b'会产生空行，需加WHERE TRIM(s.value) ''过滤 - 输入为
NULL时，STRING_SPLIT返回空表，CROSS APPLY后整行消失，可能漏数据；建议开头加判空：IF @TagList IS NULL OR LTRIM(@TagList) = '' RETURN; - 分隔符本身不能是
NULL或空字符串，否则返回空结果集，且无任何警告
INSERT 批量插入必须用 INSERT … SELECT，不能用 VALUES
想把逗号字符串拆开后批量插入目标表？别写成 INSERT INTO t(col) VALUES (SELECT value FROM STRING_SPLIT(@s, ',')) —— 这会报错“子查询返回多行”。
正确写法只有一种：
INSERT INTO tag_assignments (post_id, tag) SELECT @post_id, TRIM(s.value) FROM STRING_SPLIT(@TagList, ',') s WHERE TRIM(s.value) <> '';
- 不能在
VALUES里嵌套表值函数，这是语法硬限制 - 如果目标表有自增主键或默认值，
INSERT … SELECT能自然继承，不用额外处理 - 若需去重插入，先套一层
SELECT DISTINCT：SELECT DISTINCT TRIM(s.value) FROM STRING_SPLIT(...)
兼容性与性能容易被忽略的三个点
STRING_SPLIT 看似简单，但上线前常因环境差异翻车。
- 数据库兼容级别必须 ≥ 130（对应 SQL Server 2016+），低于该版本会提示“找不到对象”，检查命令：
SELECT compatibility_level FROM sys.databases WHERE name = DB_NAME(); - 输入字符串超过 8000 字节时，拆分性能明显下降，尤其在循环调用场景下；建议在应用层做长度截断（如 > 4000 字符则告警）
- 不要用游标遍历
STRING_SPLIT结果——99% 的需求都能改写成集合操作，比如用UPDATE ... FROM ... INNER JOIN STRING_SPLIT(...)代替逐行更新
最麻烦的其实是顺序不可靠：如果你的业务逻辑强依赖“第 N 个值代表某种含义”，2017 就得自己编号，比如用临时表 + ROW_NUMBER() OVER (ORDER BY (SELECT 0))，但要注意 (SELECT 0) 在某些执行计划下仍可能乱序，稳妥起见还是前端控制输入结构。
