如何在SSDT项目预部署脚本中编译自定义表值函数用于数据迁移

• SQLCMD 的:r命令属于预处理指令，会在所有T-SQL逻辑执行前，直接将引用的SQL文件内容原封不动插入到当前位置。你之前把:r写在IF BEGIN...END块内，相当于直接把CREATE FUNCTION语句插入到了逻辑块中，违反了CREATE FUNCTION必须是当前批内唯一语句的限制。
• GO是SQL Server的批分隔符，不能出现在BEGIN...END逻辑块内部，因此尝试添加GO分隔的方案也会报错。

方案1：动态SQL包装创建逻辑（推荐，无需修改现有项目配置） #

直接在预部署脚本中用EXEC()包裹完整的函数创建语句，动态SQL的执行上下文是独立的，天然满足单批要求：

IF OBJECT_ID('[MySchema].[MyFunc]', 'TF') IS NULL
BEGIN
    EXEC('
CREATE FUNCTION [MySchema].[MyFunc]
(
    @p1 VARCHAR(255)
)
RETURNS @returntable TABLE
(
    some_col NVARCHAR(MAX)
)
AS
BEGIN
    -- 你的函数逻辑原样粘贴到此处即可
    RETURN
END
    ')
END
GO

注意：如果函数逻辑中包含单引号，将单引号转义为两个单引号即可。函数创建完成后，后续的预部署脚本可以直接正常调用该函数。

方案2：复用现有函数文件，通过SQLCMD条件控制引入 #

如果你不想重复编写函数代码，希望直接复用项目中已有的.\MySchema\Functions\MyFunc.sql文件，可以使用SQLCMD原生的条件判断逻辑（而非T-SQL运行时判断）控制文件引入：

-- 先检测函数是否存在，将结果存入临时表
IF OBJECT_ID('[MySchema].[MyFunc]', 'TF') IS NULL
    SELECT 1 AS NeedCreateFunc INTO #FuncCheck
ELSE
    SELECT 0 AS NeedCreateFunc INTO #FuncCheck
GO

-- 将检测结果赋值给SQLCMD变量
:setvar NeedCreateFunc 0
SELECT @NeedCreateFunc = NeedCreateFunc FROM #FuncCheck
GO

-- 用SQLCMD预处理器条件判断是否引入函数文件
:if $(NeedCreateFunc) = 1
:r .\MySchema\Functions\MyFunc.sql
GO

注意：该方案依赖SSDT发布默认开启的SQLCMD模式，无需额外配置。预部署阶段创建的函数不会和后续正式部署的同名函数冲突，SSDT会自动检测对象存在性，跳过重复创建步骤。

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