本文将解释如何在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执行该函数,你应该能够观察到相应的结果。