hsrzyn

SQLCLR

什么是SQLCLR

SQL CLR (SQL Common Language Runtime) 是自 SQL Server 2005 才出现的新功能，它将.NET Framework中的CLR服务注入到 SQL Server 中，使得.NET代码可在SQL Server服务器进程中执行。

通过在 Microsoft SQL Server 中托管 CLR（称为 CLR 集成），开发人员可以在托管代码中编写存储过程、触发器、用户定义函数、用户定义类型和用户定义聚合函数, 改变了以前只能通过T-SQL语言来实现这些功能的局面。因为托管代码在执行之前会编译为本机代码，所以，在有些方案中可以大大提高性能。

SQLCLR实例

Visual Studio 2008提供了“SQL Server项目”类型，在这种类型的项目中，为5种基本SQL CLR实体定义了模板，使开发人员可以很容易的创建SQL CLR代码。

存储过程

打开vs2010，新建项目，选择“数据库”项目类型

点击确定后会让选择“数据库连接”，连接到目标数据库。

在项目中右键新建，发现可以新建的类型有函数、存储过程、聚合函数、触发器和用户自定义类型：

选择“新建存储过程”，生成的方法有“Microsoft.SqlServer.Server.SqlProcedure”标记，稍作修改，如下所示：

[Microsoft.SqlServer.Server.SqlProcedure]

public static void HelloPro(SqlString name)

{

SqlContext.Pipe.Send("Hello, " + name.ToString());

}

一个简单的存储过程就建好了（就是.net.中的一个方法），但是要注意该存储过程是没有返回值的。部署后测试（关于如何部署将在下一节演示）如下图所示：

例子中的类引用了System.Data.SqlTypes命名空间，其包含了SQL Server 中本地数据类型对应的类型，比如上面的SqlString类型对应于数据库中的 nvarchar，长度最大为 4000 。这些类提供一种比.NET Framework 公共语言运行库 (CLR) 提供的数据类型更快更安全的替代方案。使用此命名空间中的类有助于防止类型转换错误时出现精度损失的情况。还引用了Microsoft.SqlServer.Server 命名空间，该命名空间包含将 Microsoft .NET Framework 公共语言运行库 (CLR) 集成到 Microsoft SQL Server和SQL Server 数据库引擎进程执行环境时所要用到的类、接口和枚举。

代码使用了SqlContext.Pipe.Send()方法，它的目的是将字符串消息直接发送到客户端或当前输出使用者，如果没有这行代码，那么执行该存储过程后获取不到任何值。

上面那个例子没有返回值，也没有与数据库交互，下面这个例子与数据库交互：

[Microsoft.SqlServer.Server.SqlProcedure]

public static Int32 GetStudentIdByName(SqlString name)

{

int id = 0;

//使用上下文连接，也就是当前数据库连接

using (SqlConnection conn = new SqlConnection("context connection=true"))

{

SqlCommand cmd = new SqlCommand();

cmd.CommandText = "select id_student,name_student from student where name_student =@name";

SqlParameter paraname = new SqlParameter ("@name",SqlDbType .NVarChar ,4000);

paraname.Value = name;

cmd.Parameters.Add(paraname);

cmd.Connection = conn;

conn.Open();

SqlDataReader reader = cmd.ExecuteReader();

if (reader.Read())

id = reader.GetInt32(0);

reader.Close();

}

return id;

}

这个存储过程实现的功能是根据学生的姓名获取学生的ID，其中name参数代表学生姓名，存储过程的返回值就代表ID。看测试结果

对于output型参数，只需要在参数前添加ref即可，看下面的例子

[Microsoft.SqlServer.Server.SqlProcedure]

public static void TestOutPut(ref SqlString output)

{

output = "Hello," + output;

}

在此仅仅是做一例子说明问题，查看测试结果

存储过程也可以返回结果集，看代码

[Microsoft.SqlServer.Server.SqlProcedure]

public static void GetStudentByClassID(SqlInt32 id_class)

{

using (SqlConnection conn = new SqlConnection("context connection=true"))

{

SqlCommand cmd = new SqlCommand();

cmd.CommandText = "select id_student,name_student from student where id_class =@id";

SqlParameter paraname = new SqlParameter("@id", SqlDbType.Int );

paraname.Value = id_class;

cmd.Parameters.Add(paraname);

cmd.Connection = conn;

conn.Open();

SqlDataReader reader = cmd.ExecuteReader();

SqlContext.Pipe.Send(reader);

}

上面的代码是根据班级的ID获取学生的信息，测试结果：

在该例子中，也使用到了SqlContext.Pipe.Send()，而且发送的是SqlDataReader类型。该方法目前提供了三个重载方法，除了string、SqlDataReader外，还有SqlDataRecord。SqlDataRecord表示结果中的单个数据行及其元数据。

部署

在SQL Server2005/2008里面，CLR默认是关闭的。可以使用如下SQL语句开启CLR。

查看状态：

sp_configure 'clr enabled'

开启

exec sp_configure 'clr enabled',1 --1,启用clr\0,禁用clr

reconfigure

添加程序集：

create ASSEMBLY [mySQLCLR]

FROM 'd:\mySQLCLR.dll'

WITH PERMISSION_SET = SAFE

其中，from后面的表示dll文件的路径。利用下面的SQL可以查看该数据库已经注册的程序集。

select * from sys.assemblies

注册存储过程：

上述四个存储过程对应的注册SQL语句是：

CREATE PROCEDURE [dbo].[HelloPro]

@name [nvarchar](4000)