当前位置：首页 > 问答 > 正文

SQL Server数据库里托管代码怎么用，步骤和细节全讲解一点都不绕

盈壮
问答
2026-01-10 08:01:18
2

要理解SQL Server里的托管代码，你首先得知道SQL Server这个数据库软件不仅能存数据、用T-SQL语言写存储过程，它还能让你用一种更强大的编程语言（比如C#或者VB.NET）来写代码，并把这些代码直接放在数据库里运行，这些用.NET语言写的代码，就叫做“托管代码”。（来源：基于SQL Server CLR集成的基本概念）

为什么要用托管代码？

你可能会问，有T-SQL为什么还要用这个？因为T-SQL擅长的是对数据进行增删改查，但碰到复杂的逻辑计算、字符串处理、或者需要调用一些外部资源（比如网络功能、复杂的加密算法）时，它就有点力不从心了，而C#这类语言处理这些任务非常强大和高效，把托管代码用在数据库里，主要是为了弥补T-SQL的短板，处理那些T-SQL不擅长的事情。（来源：CLR集成的优势和应用场景分析）

使用步骤和细节全讲解

下面我一步一步告诉你具体怎么做,一点都不绕。

第一步：开启数据库的“特殊功能”

这个功能默认是关着的，因为微软觉得不是所有人都需要用,你得先把它打开。

打开SQL Server Management Studio (SSMS),就是那个管理数据库的软件。
新建一个查询窗口，连接到你想要用的那个SQL Server服务器。
在查询窗口里输入下面这行命令,然后点执行：
```
sp_configure 'clr enabled', 1;
RECONFIGURE;
```
（来源：SQL Server配置CLR集成的标准命令）

这行命令的意思就是把“clr enabled”（CLR启用）这个配置项的值设为1（1代表开启），执行成功后，会提示“配置选项 'clr enabled' 已从0更改为1”，这就好比你家有个高级音响，你得先插上电源开关,才能用它的蓝牙功能。

第二步：用Visual Studio编写你的C#代码

你不能随便写个C#程序就扔进去,需要创建一个特定类型的项目。

打开Visual Studio（建议用2019或更高版本）。
新建项目，在项目模板里找到“数据库”分类，然后选择“SQL Server 数据库项目”，或者，更直接的方法是，选择“类库（.NET Framework）”项目。关键点：一定要选.NET Framework，不能选.NET Core或.NET 5/6/7/8，因为SQL Server的CLR集成目前只支持传统的.NET Framework。（来源：创建SQL Server CLR项目对.NET框架版本的要求）
给你的项目起个名字，MyFirstSQLCLR”。
项目创建好后，你需要添加一个“SQL CLR”类型的项，右键点击项目 -> 添加 -> 新建项，在弹出的窗口里，你会看到几种SQL CLR的模板：
- SQL CLR C# 存储过程：这就是用来写替代T-SQL存储过程的。
- SQL CLR C# 用户定义函数：用来写自定义函数的。
- SQL CLR C# 触发器：用来写触发器的。
- SQL CLR C# 聚合函数：用来写高级的聚合函数（比如求中位数，T-SQL自带的SUM/AVG做不到）。
假设我们添加一个“SQL CLR C# 存储过程”，Visual Studio会自动生成一段代码框架，里面有一个方法，上面有[Microsoft.SqlServer.Server.SqlProcedure]这样的标记，这个标记非常重要，它告诉SQL Server：“嗨，这个方法是一个存储过程！”（来源：SQL Server CLR存储过程的属性标注）

在这个方法里写你的C#逻辑，举个例子,一个简单的将两个字符串连接起来的存储过程：

using System;
using System.Data;
using System.Data.SqlClient;
using System.Data.SqlTypes;
using Microsoft.SqlServer.Server;
public partial class StoredProcedures
{
    [Microsoft.SqlServer.Server.SqlProcedure]
    public static void ConcatenateStrings (SqlString str1, SqlString str2, out SqlString result)
    {
        // 把传入的两个字符串连接起来
        result = str1 + " " + str2;
        // 如果你想发送消息回客户端（比如像T-SQL的PRINT），可以用这个
        SqlContext.Pipe.Send("连接完成！结果是：" + result);
    }
};

（来源：基于SQL Server CLR编程模型示例）

注意：参数类型用的是SqlString、SqlInt32等，而不是普通的string和int,这是为了和数据库里的数据类型更好地对应。

第三步：把写好的代码“发布”到数据库里

代码写好了，怎么把它弄进SQL Server呢？你需要生成一个DLL文件（程序集），然后把这个DLL“上传”到数据库。

在Visual Studio里，右键点击项目，选择“生成”，如果没问题，会在项目的bin\Debug文件夹下生成一个.dll文件。
回到SSMS的查询窗口，现在要做两件事：先创建程序集，再基于程序集创建存储过程（或函数）。
创建程序集：这步是把DLL文件的内容加载到数据库系统中。
```
CREATE ASSEMBLY MyFirstAssembly
FROM 'C:\YourProjectPath\MyFirstSQLCLR\bin\Debug\MyFirstSQLCLR.dll'
WITH PERMISSION_SET = SAFE;
```
（来源：CREATE ASSEMBLY语句的语法和用法）
- MyFirstAssembly：是你在数据库里给这个程序集起的名字,可以自定义。
- FROM后面跟着的是你电脑上那个DLL文件的完整路径，如果数据库服务器和你的电脑不是同一台机器，你需要把DLL文件放到一个数据库服务器能访问的位置，或者用十六进制字节能有另一种写法（更复杂，这里不展开）。
- WITH PERMISSION_SET = SAFE：这是安全设置，超级重要！SAFE是最严格的，表示你的代码只能进行内部计算和访问本地数据，如果你的代码需要读文件、访问网络等，需要设置为EXTERNAL_ACCESS或UNSAFE（这需要更高级的权限，有安全风险）。（来源：CLR程序集权限集（SAFE, EXTERNAL_ACCESS, UNSAFE）的详细解释）
创建存储过程：现在程序集已经在数据库里了，你需要告诉SQL Server,这个程序集里的哪个方法对应一个存储过程。
```
CREATE PROCEDURE dbo.CLR_ConcatenateStrings
    @str1 NVARCHAR(100),
    @str2 NVARCHAR(100),
    @result NVARCHAR(200) OUTPUT
AS
EXTERNAL NAME MyFirstAssembly.[StoredProcedures].ConcatenateStrings;
```
（来源：CREATE PROCEDURE ... EXTERNAL NAME语句的语法）
- dbo.CLR_ConcatenateStrings：这是在数据库里创建的存储过程的名字。
- @str1，@str2，@result OUTPUT：定义参数，要和C#方法里的参数对应。
- EXTERNAL NAME：这是核心，它指明了这个存储过程实际对应的是哪个代码。MyFirstAssembly是程序集名，[StoredProcedures]是类名（如果类有命名空间，需要包含进来），ConcatenateStrings是方法名。

第四步：像普通存储过程一样使用它

这个用C#写的托管代码存储过程就可以像T-SQL存储过程一样被调用了。

DECLARE @OutputResult NVARCHAR(200);
EXEC dbo.CLR_ConcatenateStrings 'Hello', 'World', @OutputResult OUTPUT;
SELECT @OutputResult AS CombinedString;

执行这段代码,你就能看到结果了。

重要的细节和提醒

性能考量：不是所有情况都用CLR好，对于纯数据访问（比如简单的查询、更新），T-SQL通常更快，因为它更贴近数据，CLR的优势在于复杂逻辑,所以要用对地方。
安全第一：权限集一定要谨慎设置，能用SAFE就不要用EXTERNAL_ACCESS，绝对不要轻易用UNSAFE,这可能会让你的数据库面临安全威胁。
部署麻烦：相比T-SQL脚本，CLR的部署步骤多（要编译、要传DLL、要先后运行两条SQL命令），维护起来也更复杂，如果只是改一点逻辑，你可能需要重新生成DLL，然后先删除存储过程，再删除旧程序集,最后重新创建。
环境依赖：确保数据库服务器的.NET Framework版本和你开发用的版本兼容。

在SQL Server里用托管代码，核心就是“编写.NET代码 -> 编译成DLL -> 用CREATE ASSEMBLY加载到数据库 -> 用CREATE PROCEDURE/FUNCTION绑定到具体对象”这个过程，它是一把强大的瑞士军刀，专门用来解决T-SQL解决不了的复杂问题。