资源来源:https://www.cnblogs.com/Brambling/p/8016060.html
SQL Server CLR 使用 C# 自定义存储过程和触发器
这一篇博客接着上一篇博客继续介绍 SQL CLR Stored Procedure 和 CLR Trigger,
上一篇博客介绍了 SQL CLR Function 的使用,以及 CLR 程序集的注册和 CLR Function 的注册。
我的上一篇博客:SQL Server CLR 使用 C# 自定义函数
四、CLR Stored Procedure
接下来在之前的项目选择添加新项,选择 SQL CLR C# 存储过程。
public partial class StoredProcedures
{
/// <summary>
/// 无输入参数,无输出参数,无输出结果,有输出消息,无返回值的存储过程
/// </summary>
[Microsoft.SqlServer.Server.SqlProcedure(Name = "HelloWorld")]
public static void HelloWorld()
{
SqlContext.Pipe.Send("Hello World");
} /// <summary>
/// 有输入参数,无输出参数,无输出结果,无输出消息,有返回值的存储过程
/// </summary>
/// <param name="name"></param>
[Microsoft.SqlServer.Server.SqlProcedure(Name = "GetStrLength")]
public static SqlInt32 GetStrLength(SqlString str)
{
return str.ToString().Length;
} /// <summary>
/// 有输入参数,有输出参数,无输出结果,无输出消息,无返回值的存储过程
/// </summary>
/// <param name="name"></param>
[Microsoft.SqlServer.Server.SqlProcedure(Name = "SayHello")]
public static void SayHello(SqlString name,out SqlString sayHello)
{
sayHello = "Hello " + name.ToString();
}
}
注册程序集和注册存储过程的 SQL 后面再贴出来,这里我们先看看结果。
PS:如果你用的是 Visual Studio 2015,那么你可以在【项目路径>obj>Debug】文件夹下面找到自动生成的注册程序集和存储过程的 SQL 语句。至于其他版本大家可以试试。
执行存储过程 HelloWorld:
--执行存储过程 HelloWorld
exec [dbo].[HelloWorld]
结果:
这就是输出消息,输出消息和输出结果是不一样的,输出消息是没办法获取的(我没办法),而输出结果就相当于用 Select 语句查询出来的结果一样,是可以获取的。
执行存储过程 GetStrLength:
--执行存储过程 GetStrLength
declare @res int
exec @res=[dbo].[GetStrLength] '123456'
select @res
结果:
这个 C# 代码里面是有返回值的,也可以通过这种方式获取到返回值,但是这种返回值的方式只能返回 int 类型的返回值。
如果需要多个返回值呢?看下面的存储过程,可以通过设置多个输出参数来达到。
执行存储过程 SayHello:
--执行存储过程 SayHello
declare @SayHello nvarchar(32)
exec [dbo].[SayHello] 'Brambling',@SayHello output select @SayHello
结果:
其实弄明白输入参数、输出参数、输出消息、输出结果和返回值这几个问题,CLR 存储过程的介绍就可以完了。
但是存储过程里面总是免不了要操作数据的,那么下面就看看对于数据库数据的操作和输出结果集的方法吧。
/// <summary>
/// 根据学生学号获取学生姓名
/// </summary>
/// <param name="Id"></param>
/// <returns></returns>
[Microsoft.SqlServer.Server.SqlProcedure(Name = "GetStudentNameByStuNo")]
public static void GetStudentNameByStuNo(SqlString stuNo,out SqlString stoName)
{
stoName = string.Empty; //因为程序是在SQL Server内执行,所以连接字符串写成"context connection=true"即可
using (SqlConnection conn = new SqlConnection("context connection=true"))
{
SqlCommand comm = new SqlCommand();
comm.CommandText = "select StuName from StudentInfo where StuNo=@StuNo;"; SqlParameter param = new SqlParameter("@StuNo", SqlDbType.NVarChar, 4000);
param.SqlValue = stuNo;
comm.Parameters.Add(param); comm.Connection = conn;
conn.Open();
SqlDataReader dataReader = comm.ExecuteReader();
if (dataReader.Read())
{
stoName = dataReader.GetString(0);
}
dataReader.Close();
}
}
执行存储过程 GetStudentNameByStuNo:
declare @StuName nvarchar(32)
exec [GetStudentNameByStuNo] 'A001',@StuName output
select @StuName
exec [GetStudentNameByStuNo] 'A003',@StuName output
select @StuName
结果:
可以看到我们通过输出参数获取到了返回值。如果现在我需要获取整个学生的所有信息呢?
虽然可以通过设置多个输出参数得到,但是学生信息的字段过多呢?下面看看输出结果集的方式。
/// <summary>
/// 根据学生的学号获取该学生的所有信息
/// 返回的是一个结果集,即有多少条数据就返回多少条数据
/// </summary>
/// <param name="stuNo"></param>
[Microsoft.SqlServer.Server.SqlProcedure(Name = "GetStudentInfoByStuNo_First")]
public static void GetStudentInfoByStuNo_First(SqlString stuNo)
{
using (SqlConnection conn = new SqlConnection("context connection=true"))
{
SqlCommand comm = new SqlCommand();
comm.CommandText = "select ID,StuNo,StuName,StuAge from StudentInfo where StuNo=@StuNo;"; SqlParameter param = new SqlParameter("@StuNo", SqlDbType.NVarChar, 4000);
param.SqlValue = stuNo;
comm.Parameters.Add(param); comm.Connection = conn;
conn.Open();
SqlDataReader dataReader = comm.ExecuteReader();
SqlContext.Pipe.Send(dataReader);
dataReader.Close();
}
} /// <summary>
/// 根据学生的学号获取该学生的所有信息
/// 这种方式效率比较高,是通过直接执行 SqlCommand 指令,然后把数据发送到客户端,不需要经过托管内存
/// </summary>
/// <param name="stuNo"></param>
[Microsoft.SqlServer.Server.SqlProcedure(Name = "GetStudentInfoByStuNo_Second")]
public static void GetStudentInfoByStuNo_Second(SqlString stuNo)
{
using (SqlConnection conn = new SqlConnection("context connection=true"))
{
SqlCommand comm = new SqlCommand();
comm.CommandText = "select ID,StuNo,StuName,StuAge from StudentInfo where StuNo=@StuNo;"; SqlParameter param = new SqlParameter("@StuNo", SqlDbType.NVarChar, 4000);
param.SqlValue = stuNo;
comm.Parameters.Add(param); comm.Connection = conn;
conn.Open();
SqlContext.Pipe.ExecuteAndSend(comm);
}
} /// <summary>
/// 根据学生的学号获取该学生的所有信息
/// </summary>
/// <param name="stuNo"></param>
[Microsoft.SqlServer.Server.SqlProcedure(Name = "GetStudentInfoByStuNo_Third")]
public static void GetStudentInfoByStuNo_Third(SqlString stuNo)
{
using (SqlConnection conn = new SqlConnection("context connection=true"))
{
SqlCommand comm = new SqlCommand();
comm.CommandText = "select ID,StuNo,StuName,StuAge from StudentInfo where StuNo=@StuNo;"; SqlParameter param = new SqlParameter("@StuNo", SqlDbType.NVarChar, 4000);
param.SqlValue = stuNo;
comm.Parameters.Add(param); comm.Connection = conn;
conn.Open();
SqlDataReader dataReader = comm.ExecuteReader(); SqlDataRecord dataRecord = new SqlDataRecord(
new SqlMetaData[]
{
new SqlMetaData("ID",SqlDbType.Int),
new SqlMetaData("StuNo",SqlDbType.NVarChar,128),
new SqlMetaData("StuName",SqlDbType.NVarChar,128),
new SqlMetaData("StuAge",SqlDbType.Int)
}
); if(dataReader.Read())
{
dataRecord.SetInt32(0,(int)dataReader["ID"]);
dataRecord.SetString(1,(string)dataReader["StuNo"]);
dataRecord.SetString(2,(string)dataReader["StuName"]);
dataRecord.SetInt32(3,(int)dataReader["StuAge"]);
SqlContext.Pipe.Send(dataRecord);
}
dataReader.Close();
}
}
执行存储过程:
--执行存储过程 GetStudentInfoByStuNo_First
exec [GetStudentInfoByStuNo_First] 'A003' --执行存储过程 GetStudentInfoByStuNo_Second
exec [GetStudentInfoByStuNo_Second] 'A003' --执行存储过程 GetStudentInfoByStuNo_Third
exec [GetStudentInfoByStuNo_Third] 'A003'
结果:
上面三个方法中,第一个方法和第二个方法都是直接返回查询结果的,但是在实际存储过程当中是不会这样写的,里面应该包含有逻辑操作等等,所以就有了第三个方法。
那么现在是返回的一条数据,如果是返回多条数据呢?第一种方法和第二种方法就不说了,因为这两种方法都是返回结果集的。
/// <summary>
/// 根据年龄查询学生的信息
/// 这种方式是一条数据返回一个结果集
/// </summary>
/// <param name="stuAge"></param>
[Microsoft.SqlServer.Server.SqlProcedure(Name = "GetStudentsInfoByStuAge_Single")]
public static void GetStudentsInfoByStuAge_Single(SqlInt32 stuAge)
{
using (SqlConnection conn = new SqlConnection("context connection=true"))
{
SqlCommand comm = new SqlCommand();
comm.CommandText = "select ID,StuNo,StuName,StuAge from StudentInfo where StuAge=@StuAge;"; SqlParameter param = new SqlParameter("@StuAge", SqlDbType.Int);
param.SqlValue = stuAge;
comm.Parameters.Add(param); comm.Connection = conn;
conn.Open();
SqlDataReader dataReader = comm.ExecuteReader(); SqlDataRecord dataRecord = new SqlDataRecord(
new SqlMetaData[]
{
new SqlMetaData("ID",SqlDbType.Int),
new SqlMetaData("StuNo",SqlDbType.NVarChar,128),
new SqlMetaData("StuName",SqlDbType.NVarChar,128),
new SqlMetaData("StuAge",SqlDbType.Int)
}
); while (dataReader.Read())
{
dataRecord.SetInt32(0, (int)dataReader["ID"]);
dataRecord.SetString(1, (string)dataReader["StuNo"]);
dataRecord.SetString(2, (string)dataReader["StuName"]);
dataRecord.SetInt32(3, (int)dataReader["StuAge"]);
//发送结果集到客户端
SqlContext.Pipe.Send(dataRecord);
}
dataReader.Close();
}
} /// <summary>
/// 根据年龄查询学生的信息
/// 这种方式是所有的数据返回一个结果集
/// </summary>
/// <param name="stuAge"></param>
[Microsoft.SqlServer.Server.SqlProcedure(Name = "GetStudentsInfoByStuAge_Multiple")]
public static void GetStudentsInfoByStuAge_Multiple(SqlInt32 stuAge)
{
using (SqlConnection conn = new SqlConnection("context connection=true"))
{
SqlCommand comm = new SqlCommand();
comm.CommandText = "select ID,StuNo,StuName,StuAge from StudentInfo where StuAge=@StuAge;"; SqlParameter param = new SqlParameter("@StuAge", SqlDbType.Int);
param.SqlValue = stuAge;
comm.Parameters.Add(param); comm.Connection = conn;
conn.Open();
SqlDataReader dataReader = comm.ExecuteReader(); SqlDataRecord dataRecord = new SqlDataRecord(
new SqlMetaData[]
{
new SqlMetaData("ID",SqlDbType.Int),
new SqlMetaData("StuNo",SqlDbType.NVarChar,128),
new SqlMetaData("StuName",SqlDbType.NVarChar,128),
new SqlMetaData("StuAge",SqlDbType.Int)
}
); //标记结果集的开始
SqlContext.Pipe.SendResultsStart(dataRecord);
while (dataReader.Read())
{
dataRecord.SetInt32(0, (int)dataReader["ID"]);
dataRecord.SetString(1, (string)dataReader["StuNo"]);
dataRecord.SetString(2, (string)dataReader["StuName"]);
dataRecord.SetInt32(3, (int)dataReader["StuAge"]);
//填充数据到结果集
SqlContext.Pipe.SendResultsRow(dataRecord);
}
//标记结果集的结束
SqlContext.Pipe.SendResultsEnd();
dataReader.Close();
}
}
执行存储过程:
--执行存储过程 GetStudentsInfoByStuAge_Single
exec [dbo].[GetStudentsInfoByStuAge_Single] '18' --执行存储过程 GetStudentsInfoByStuAge_Multiple
exec [dbo].[GetStudentsInfoByStuAge_Multiple] '18'
结果:
可以很清楚的看到,方法一是一条数据返回一个结果集,方法二是所有数据返回一个结果集。
下面贴出注册存储过程的 SQL 语句,注册程序集的就不贴了,我的上一篇博客有过介绍。
--注册存储过程 HelloWorld
CREATE PROCEDURE [dbo].[HelloWorld]
WITH EXECUTE AS CALLER
AS
EXTERNAL NAME [UserDefinedSqlClr].[StoredProcedures].[HelloWorld]; --EXTERNAL NAME 程序集名.类名.方法名
GO --注册存储过程 GetStrLength
CREATE PROCEDURE [dbo].[GetStrLength]
@str [nvarchar](MAX)
WITH EXECUTE AS CALLER
AS
EXTERNAL NAME [UserDefinedSqlClr].[StoredProcedures].[GetStrLength]; --EXTERNAL NAME 程序集名.类名.方法名
GO --注册存储过程 SayHello
CREATE PROCEDURE [dbo].[SayHello]
@name [nvarchar](MAX),
@sayHello [nvarchar](MAX) OUTPUT
WITH EXECUTE AS CALLER
AS
EXTERNAL NAME [UserDefinedSqlClr].[StoredProcedures].[SayHello]; --EXTERNAL NAME 程序集名.类名.方法名
GO --注册存储过程 GetStudentNameByStuNo
CREATE PROCEDURE [dbo].[GetStudentNameByStuNo]
@stuNo [nvarchar](MAX),
@stoName [nvarchar](MAX) OUTPUT
WITH EXECUTE AS CALLER
AS
EXTERNAL NAME [UserDefinedSqlClr].[StoredProcedures].[GetStudentNameByStuNo]; --EXTERNAL NAME 程序集名.类名.方法名
GO --注册存储过程 GetStudentInfoByStuNo_First
CREATE PROCEDURE [dbo].[GetStudentInfoByStuNo_First]
@stuNo [nvarchar](MAX)
WITH EXECUTE AS CALLER
AS
EXTERNAL NAME [UserDefinedSqlClr].[StoredProcedures].[GetStudentInfoByStuNo_First]; --EXTERNAL NAME 程序集名.类名.方法名
GO --注册存储过程 GetStudentInfoByStuNo_Second
CREATE PROCEDURE [dbo].[GetStudentInfoByStuNo_Second]
@stuNo [nvarchar](MAX)
WITH EXECUTE AS CALLER
AS
EXTERNAL NAME [UserDefinedSqlClr].[StoredProcedures].[GetStudentInfoByStuNo_Second]; --EXTERNAL NAME 程序集名.类名.方法名
GO --注册存储过程 GetStudentInfoByStuNo_Third
CREATE PROCEDURE [dbo].[GetStudentInfoByStuNo_Third]
@stuNo [nvarchar](MAX)
WITH EXECUTE AS CALLER
AS
EXTERNAL NAME [UserDefinedSqlClr].[StoredProcedures].[GetStudentInfoByStuNo_Third]; --EXTERNAL NAME 程序集名.类名.方法名
GO --注册存储过程 GetStudentsInfoByStuAge_Single
CREATE PROCEDURE [dbo].[GetStudentsInfoByStuAge_Single]
@stuAge [int]
WITH EXECUTE AS CALLER
AS
EXTERNAL NAME [UserDefinedSqlClr].[StoredProcedures].[GetStudentsInfoByStuAge_Single]; --EXTERNAL NAME 程序集名.类名.方法名
GO --注册存储过程 GetStudentsInfoByStuAge_Multiple
CREATE PROCEDURE [dbo].[GetStudentsInfoByStuAge_Multiple]
@stuAge [int]
WITH EXECUTE AS CALLER
AS
EXTERNAL NAME [UserDefinedSqlClr].[StoredProcedures].[GetStudentsInfoByStuAge_Multiple]; --EXTERNAL NAME 程序集名.类名.方法名
GO
五、CLR Trigger
接下来选择添加新项,选择 SQL CLR C# 触发器。
1、DML 触发器
(1) after trigger
public partial class Triggers
{
/// <summary>
/// 输出操作的数据
/// </summary>
[Microsoft.SqlServer.Server.SqlTrigger(Name = "FirstSqlTrigger", Target = "StudentInfo", Event = "FOR INSERT,UPDATE,DELETE")]
public static void FirstSqlTrigger()
{
switch (SqlContext.TriggerContext.TriggerAction)
{
case TriggerAction.Insert:
GetInsertedOrDeleted(InsOrDel.Inserted);
break;
case TriggerAction.Update:
GetInsertedOrDeleted(InsOrDel.Inserted);
GetInsertedOrDeleted(InsOrDel.Deleted);
break;
case TriggerAction.Delete:
GetInsertedOrDeleted(InsOrDel.Deleted);
break;
default:
break;
}
} /// <summary>
/// 获取操作的数据或之后的数据
/// </summary>
/// <param name="insOrDel"></param>
/// <returns></returns>
private static void GetInsertedOrDeleted(InsOrDel insOrDel)
{
using (SqlConnection conn = new SqlConnection("context connection=true"))
{
SqlCommand comm = new SqlCommand();
comm.CommandText = "select ID,StuNo,StuName,StuAge from " + insOrDel.ToString() + ";";
comm.Connection = conn;
conn.Open();
SqlDataReader dataReader = comm.ExecuteReader(); SqlDataRecord dataRecord = new SqlDataRecord(
new SqlMetaData[]
{
new SqlMetaData("ID",SqlDbType.Int),
new SqlMetaData("StuNo",SqlDbType.NVarChar,128),
new SqlMetaData("StuName",SqlDbType.NVarChar,128),
new SqlMetaData("StuAge",SqlDbType.Int)
}
); if (dataReader.Read())
{
dataRecord.SetInt32(0, (int)dataReader["ID"]);
dataRecord.SetString(1, (string)dataReader["StuNo"]);
dataRecord.SetString(2, (string)dataReader["StuName"]);
dataRecord.SetInt32(3, (int)dataReader["StuAge"]);
//发送结果集到客户端
SqlContext.Pipe.Send(dataRecord);
}
dataReader.Close();
}
} private enum InsOrDel
{
Inserted,
Deleted
}
}
测试 SQL 语句:
-- Insert 操作
insert into StudentInfo(StuNo,StuName,StuAge)
values('A006','小飞',20) -- Update 操作
update StudentInfo set StuName='小飞飞' where StuNo='A006' -- Delete 操作
delete from StudentInfo where StuNo='A006'
结果:
这里说明一下,Microsoft.SqlServer.Server.SqlTrigger 有三个属性。
Name:表示触发器的名称。
Target:表示触发器的目标表的名称。
Event:表示触发执行触发器的动作。
(2) instead of trigger
public partial class Triggers
{
/// <summary>
/// 输出操作类型
/// </summary>
[Microsoft.SqlServer.Server.SqlTrigger(Name = "InsteadOfTrigger",Target = "StudentInfo",Event = "INSTEAD OF INSERT,UPDATE,DELETE")]
public static void InsteadOfTrigger()
{
SqlDataRecord dataRecord = new SqlDataRecord(
new SqlMetaData[]
{
new SqlMetaData("Message",SqlDbType.NVarChar,128)
}
); switch (SqlContext.TriggerContext.TriggerAction)
{
case TriggerAction.Insert:
dataRecord.SetString(0, "Insert操作");
break;
case TriggerAction.Update:
dataRecord.SetString(0, "Update操作");
break;
case TriggerAction.Delete:
dataRecord.SetString(0, "Delete操作");
break;
default:
dataRecord.SetString(0, "Nothing");
break;
}
SqlContext.Pipe.Send(dataRecord);
}
}
测试 SQL 语句:
-- Insert 操作
insert into StudentInfo(StuNo,StuName,StuAge)
values('A006','小飞',20) -- Update 操作
update StudentInfo set StuName='小飞飞' where StuNo='A006' -- Delete 操作
delete from StudentInfo where StuNo='A006'
结果:
Instead of 是一种特殊的触发器,它只执行触发器本身,也就是触发器里面的操作,
所以 Insert、Update、Delete 操作是不执行的,只是用于触发该触发器,而且 Instead of 触发器会覆盖掉 after 触发器。
2、DDL 触发器
DDL 触发器又分为数据库级别的触发器和服务器级别的触发器,这里只介绍数据库级别的触发器。
public partial class Triggers
{
/// <summary>
/// 禁止删除表和删除存储过程的 DDL 触发器
/// </summary>
[Microsoft.SqlServer.Server.SqlTrigger(Name = "SecondSqlTrigger")]
public static void SecondSqlTrigger()
{
switch (SqlContext.TriggerContext.TriggerAction)
{
case TriggerAction.DropTable:
try
{
Transaction tran = Transaction.Current;
tran.Rollback();
}
catch
{
}
SqlContext.Pipe.Send("You have no authority");
break;
case TriggerAction.DropProcedure:
try
{
Transaction tran = Transaction.Current;
tran.Rollback();
}
catch
{
}
SqlContext.Pipe.Send("You have no authority");
break;
default:
break;
}
}
}
这里 DDL 的触发器,只需要指定触发器名称的属性就可以了。
测试 SQL 语句:
--删除表 StudentInfo
drop table StudentInfo
结果:
下面贴出注册触发器的 SQL 语句。
--注册触发器 FirstSqlTrigger
CREATE TRIGGER [FirstSqlTrigger]
ON StudentInfo --目标表
FOR INSERT,UPDATE,DELETE --指定触发的操作
AS
EXTERNAL NAME [UserDefinedSqlClr].[Triggers].[FirstSqlTrigger]; --EXTERNAL NAME 程序集名.类名.方法名
GO --注册触发器 InsteadOfTrigger
CREATE TRIGGER [InsteadOfTrigger]
ON StudentInfo --目标表
INSTEAD OF INSERT,UPDATE,DELETE --指定触发的操作
AS
EXTERNAL NAME [UserDefinedSqlClr].[Triggers].[InsteadOfTrigger]; --EXTERNAL NAME 程序集名.类名.方法名
GO --注册触发器 SecondSqlTrigger
CREATE TRIGGER [SecondSqlTrigger]
ON database --数据库级别触发器
for drop_table,drop_procedure --指定触发的操作
AS
EXTERNAL NAME [UserDefinedSqlClr].[Triggers].[SecondSqlTrigger]; --EXTERNAL NAME 程序集名.类名.方法名
GO
删除存储过程和删除触发器的 SQL 语句类似,唯一需要注意的就是删除数据库级别的触发器时,需要在后面加上 on database,例如:
--删除数据库级别触发器 SecondSqlTrigger
drop trigger [SecondSqlTrigger] on database
其实触发器本身就很少用到,因为对于数据量大的时候,特别影响性能,所以这里不多做介绍。
可以参考这里:CLR 触发器
六、总结
总算写完了。。。
其实 CLR 自定义函数、存储过程和触发器等,不一定比 T-SQL 好用,准确来说性能稍微差点。
但是这只是提供一种方法,遇到 T-SQL 不能解决时可以考虑的一种方法。
毕竟了解的越多,会的越多,遇到问题处理的方法就越多。