怎样在SQL存储过程中调用C#编写的程序集_利用CLR集成技术实现

在SQL Server存储过程中调用C#程序集：一份避坑指南

想在SQL Server的存储过程里直接调用C#代码？这个想法很自然，毕竟有些复杂计算或已有.NET逻辑，用T-SQL重写既麻烦又低效。SQL Server的CLR（公共语言运行时）集成功能，正是为此而生。但请注意，这并非简单的“混搭编程”，而是一套在严格沙箱规则下的精密协作。下面这份指南，将带你理清关键步骤，并避开那些最容易踩的坑。

SQL Server中启用CLR集成的必要步骤

首先得明确，SQL Server默认是“闭关锁国”的，CLR集成处于禁用状态。如果你直接尝试创建程序集，大概率会迎面撞上这个错误：Msg 6263, Level 16, State 1: CREATE ASSEMBLY for assembly 'xxx' failed because assembly 'xxx' is not authorized for PERMISSION_SET = UNSAFE。所以，开工前必须先打开大门并设置好信任关系。

• 第一步，启用高级选项并打开CLR开关：依次执行 sp_configure 'show advanced options', 1; RECONFIGURE; 和 sp_configure 'clr enabled', 1; RECONFIGURE;。
• 第二步，设置数据库信任级别。对于开发测试环境，一个快捷但不推荐用于生产的方法是：将目标数据库设为 TRUSTWORTHY ON。为什么生产环境不推荐？因为这相当于给了数据库过高的全局信任，存在安全风险。更稳妥的生产级做法是使用证书签名方式来授权程序集。
• 额外注意：如果你的程序集需要 UNSAFE 权限（例如要调用Win32 API或进行文件IO操作），那么承载它的数据库必须由 dbo 拥有（使用 AUTHORIZATION dbo 创建），并且不能是 tempdb 或任何系统数据库。

编译C#类库时的关键约束

接下来是编写C#代码的部分。这里最大的误区是以为能在SQL Server里运行一个完整的.NET程序。事实上，SQL CLR宿主环境是一个高度受限的“沙箱”，它并非完整的.NET运行时。很多失败案例，根源不在于业务逻辑错误，而是代码触碰了沙箱的禁区。

• 框架版本是硬性要求：你的项目目标框架必须选择 .NET Framework 4.8 或更低的版本。是的，SQL Server（截至2019版本）目前尚不支持.NET Core或.NET 5及以上版本。
• 方法签名有特定格式：暴露给SQL Server的类和方法必须标记为 public static。更重要的是，方法的参数和返回值类型，必须使用SQL Server原生的SQL类型，比如 SqlInt32、SqlString、SqlDateTime。直接使用C#的 int、string 是行不通的。
• 禁止非沙箱操作：在CLR代码中，许多常见的操作是被明令禁止的，例如 Console.WriteLine、Thread.Sleep、HttpClient发起网络请求、或者动态加载程序集（Assembly.Load）。如果你需要输出调试信息，可以使用 SqlContext.Pipe.Send() 方法，它将内容发送到SSMS的消息窗口。

在存储过程中调用CLR函数或过程的写法

这里有个关键概念需要厘清：C#代码并不是直接在T-SQL脚本里被“调用”的。正确的流程是，先将编译好的.NET程序集注册为SQL Server内部的数据库对象（例如标量函数、表值函数、存储过程或聚合函数），然后像调用任何普通T-SQL对象一样去使用它。不存在那种在存储过程里随意嵌入一段C#代码的自由度。

• 创建程序集：首先，将DLL文件注册到数据库中：CREATE ASSEMBLY MyAssembly FROM 'C:\path\to\MyAssembly.dll' WITH PERMISSION_SET = SAFE;。这里的 PERMISSION_SET 需要根据程序集的实际需求，在 SAFE、EXTERNAL_ACCESS 和 UNSAFE 中选择。
• 创建T-SQL包装对象：接着，为C#方法创建一个对应的T-SQL外壳。例如，创建一个存储过程：CREATE PROCEDURE dbo.usp_DoWork @input SqlString AS EXTERNAL NAME MyAssembly.[MyNamespace.MyClass].DoWork;。这个 EXTERNAL NAME 建立了T-SQL对象与.NET方法之间的映射。
• 像普通过程一样调用：完成以上两步后，调用方式就和原生存储过程毫无二致了：EXEC dbo.usp_DoWork @input = N'test';。参数传递、错误处理等规则都遵循T-SQL的惯例。

调试和部署时最常踩的坑

到了调试和部署阶段，问题往往变得棘手。错误信息可能非常笼统，比如 Assembly not found 或 Could not load file or assembly。这时候，问题根源多半不在代码逻辑本身，而是隐藏在依赖链或权限配置的细节里。

• 依赖项必须单独注册：如果你的C#项目引用了第三方库（比如Newtonsoft.Json），那么这些依赖的DLL也必须逐个使用 CREATE ASSEMBLY 语句注册到同一个数据库中。并且，版本号和公钥令牌必须严格匹配，可以使用 sn -Tp xxx.dll 命令进行核对。
• UNSAFE权限要求更高：注册一个 UNSAFE ASSEMBLY，不仅需要数据库级别的设置，还要求数据库的拥有者（OWNER）在服务器层面具备 UNSAFE ASSEMBLY 权限。仅仅拥有 db_owner 数据库角色是不够的。
• 更新代码需先删除后创建：修改C#源代码并重新编译后，部署到SQL Server的正确流程是：先执行 DROP ASSEMBLY 删除旧程序集，再执行 CREATE ASSEMBLY 创建新的。SQL Server不会自动覆盖，残留的旧版本会导致调用时出现各种难以预料的异常。

最后，需要清醒地认识到，CLR集成并非SQL Server的通用扩展机制。它最适合的场景是CPU密集型的计算任务（例如复杂的正则表达式匹配、自定义加密解密算法），或者需要复用现有、经过验证的.NET业务逻辑。一旦你的需求涉及网络访问、文件系统操作、读取外部配置等与外界交互的行为，维护成本和权限管理的复杂度会急剧上升。在这种情况下，更优的架构选择或许是考虑使用外部服务配合SQL Agent作业，或者通过API网关来解耦。