本文将解释如何在SQL Server 2005中以尽可能最简单的方法创建基于.NET的CLR子例程。本文主要针对在服务器端使用SQL Server 2005的.NET开发者。
一、创建SQL Server 2005数据库
这一节主要讨论创建一个将用于本文中的数据库和表格。详见下列步骤：
· 执行"Start->Programs->Microsoft SQL Server 2005->SQL Server Management Studio"，并使用必要的证书连接到你的SQL Server 2005实例。
· 一旦建立连接，使用"Object Explorer"打开SQL Server 2005实例，然后右击"databases"并选择"New Database"(图1)。
图1
然后，出现一个"New Database"对话框。输入数据库名"Sample"并点击"OK"以便在同一个实例内创建新的数据库。
· 一旦创建该数据库，你一定能够在"Object explorer"中看到相同的结果。
· 使用"Object explorer"打开"Sample"数据库，右击"tables"并选择"new table"(图2)。
图2
· 创建如下图3所示的表格结构，并用"emp"保存表格。
图3
· 一旦你创建了表格"emp"，打开它(图4)并使用下列数据进行填充(图5)。
图4
图5
二、创建SQL Server 2005数据库.NET CLR存储过程
一旦你创建完数据库和表格，接下来让我们使用下列步骤在SQL Server 2005数据库中创建一个.NET CLR存储过程：
· 转到"Start -> Programs -> Microsoft Visual Studio 2005 -> Microsoft Visual Studio 2005"。
· 在"New Project"对话框内，从"Visual Basic"树的"Project Type"下选择"database"并选择"SQL Server Project"作为模板，输入名字"SampleAllInOne"。至此，该对话框应该看起来如下图6所示。
图6
· 一旦你点击"OK"，将出现一个"New Database Reference"对话框。输入你自己的实例名，并选择数据库"Sample"(在上一节创建的)，并且测试连接(图7)。
图7
· 一旦测试成功，点击"OK"创建工程。
· 然后系统出现一个对话框，它询问你是否启动CLR调试功能。请点击"Yes"(图8)。
图8
· 使用"Solution explorer"，右击"SampleAllInOne"工程，并点击"Add->Stored Procedure"(以创建一个新的存储过程)(图9)。
图9
· 之后，出现"Add New Item"对话框。在该对话框内，选择"Stored Procedure"作为模板并输入名字"IncSalaries"，最后点击"Add"(图10)。
图10
三、.NET CLR存储过程编码
一旦创建"IncSalaries.VB"，以下列方法修改你的代码，如下所示：
|
以下为引用的内容： Imports System Imports System.Data Imports System.Data.SqlClient Imports System.Data.SqlTypes Imports Microsoft.SqlServer.Server Partial Public Class StoredProcedures <Microsoft.SqlServer.Server.SqlProcedure()> _ Public Shared Sub IncSalaries(ByVal IncVal As SqlDouble) '在此添加你的代码 Using cn As New SqlConnection("context connection=true") Dim cmd As New SqlCommand("update sample.dbo.emp set sal = sal + " & IncVal.ToString， cn) cmd.Connection.Open() cmd.ExecuteNonQuery() End Using End Sub End Class |
上面是一个使用Visual Basic.NET 2005编写简单的基于CLR的存储过程，你可以把它发布到SQL Server 2005中。该存储过程名为"IncSalaries"，它只接收一个参数-"IncVal"。上面的存储过程简单地使用参数中提供的值来提高表格"emp"中每一位雇员的工资值。
四、.NET CLR存储过程测试
为了测试上面的存储过程，请遵循下列步骤：
· 使用"Solution Explorer"在"test scripts"中打开"test.sql"(图11)。
图11
· 转到最后一行，并如下修改代码：
--为运行你的工程，请编辑你的工程的Test.sql文件。
--这个文件位于Solution Explorer的"Test Scripts"文件夹下
exec IncSalaries 50
· 转到"Start->Programs->Microsoft SQL Server 2005->Configuration Tools->SQL Server Surface Area Configuration"。
· 在窗口内，点击"Surface Area Configuration for Features"(图12)。
图12
· 启动CLR集成，如下所示(图13)。
图13
· 按F5执行整个方案。如果它的执行中出现任何错误，一切都会被显示于输出窗口中。
· 如果存储过程成功执行，你应该能够看到所有的工资数增加了50。
五、SQL Server 2005数据库中的.NET CLR用户定义函数
现在，我们要在我们现有的方案上添加一个存储函数。
· 使用"Solution explorer"，右击"SampleAllInOne"工程并转到"Add->User-defined Function"(以创建一个新的存储函数)(图14)。
图14
· 之后，出现"Add New Item"对话框。在对话框内，选择"User defined function"作为模板，输入名字"getNetSalary"，最后点击"Add"(图15)。
图15
一旦创建"getNetSalary.VB"，接下来按下列方式修改你的代码：
|
以下为引用的内容： Imports System Imports System.Data Imports System.Data.SqlClient Imports System.Data.SqlTypes Imports Microsoft.SqlServer.Server PartialPublic Class UserDefinedFunctions <Microsoft.SqlServer.Server.SqlFunction (DataAccess:=DataACCESSKind.Read)> _ Public Shared Function getNetSalary(ByVal empno As SqlString) As SqlDouble '在此添加你的代码 Dim sal As Double Using cn As New SqlConnection("context connection=true") Dim cmd As New SqlCommand("select sal from sample.dbo.emp where empno='" & empno.ToString & "'"， cn) cmd.Connection.Open() sal = CType(cmd.ExecuteScalar， Double) cmd.Dispose() End Using Dim hra As Double = sal * 10 / 100 Dim ta As Double = 200 Dim gross As Double = sal + hra + ta Dim epf As Double = sal * 5 / 100 Dim net As Double = gross - epf Return net End Function End Class |
然后，使用下列步骤测试上面的存储过程：
· 使用"Solution Explorer"在"test scripts"中打开"test.sql"(见前图11)。
· 转到并修改如下代码：
--为运行你的工程，请编辑你的工程的test.sql文件。
--这个文件位于Solution Explorer的"Test Scripts"文件夹下
--exec IncSalaries 50
select dbo.getNetSalary(empno) from sample.dbo.emp
按F5执行该函数，你应该能够看到相应结果。
六、定义.NET CLR用户定义聚合器
现在，我们开始在上一节基础上在我们的现有方案上添加一个聚合函数。
· 使用"Solution explorer"，右击"SampleAllInOne"工程并转到"Add->Aggregate"(以创建一个新的聚合函数)(图16)。
图16
· 之后，出现"Add New Item"对话框。在该对话框内，选择"Aggregate"作为模板，输入名字"NetSal"并点击"Add"(图17)。
图17
一旦创建"NetSal.VB"，接下来以下列方式修改你的代码：
|
以下为引用的内容： Imports System Imports System.Data Imports System.Data.SqlClient Imports System.Data.SqlTypes Imports Microsoft.SqlServer.Server <Serializable()> _ <Microsoft.SqlServer.Server.SqlUserDefinedAggregate(Format.Native)> _ PublicStructure NetSal Public SumNetSal As SqlDouble Public Sub Init() '在此加入你的代码 SumNetSal = 0 End Sub Public Sub Accumulate(ByVal value As SqlDouble) '在此加入你的代码 Dim sal As Double = CType(value， Double) Dim hra As Double = sal * 10 / 100 Dim ta As Double = 200 Dim gross As Double = sal + hra + ta Dim epf As Double = sal * 5 / 100 Dim net As Double = gross - epf SumNetSal += net End Sub Public Sub Merge(ByVal obj As NetSal) '在此加入你的代码 SumNetSal += obj.SumNetSal End Sub Public Function Terminate() As SqlDouble '在此加入你的代码 Return SumNetSal End Function EndStructure |
为了测试上面的存储过程，遵循下列步骤：
· 使用"Solution Explorer"，然后在"test scripts"中打开"test.sql"。
· 转到最后一行并修改如下代码：
--为运行你的工程，请编辑你的工程的test.sql文件。
--这个文件位于Solution Explorer的"Test Scripts"文件夹下
--exec IncSalaries 50
--select dbo.getNetSalary(empno) from sample.dbo.emp
select dbo.NetSal(sal) from sample.dbo.emp
按F5执行该函数，你应该能够观察到相应的结果。