如何使用SQLCLR表值函数进行扩展

如何使用SQL CLR表值函数进行扩展SQL CLR

Microsoft SQL Server 2005 的一项新增功能是其与 Microsoft .NET Framework 公共语言运行库 (CLR) 的集成。这使得人们能够将 .NET Framework 类和函数纳入 Transact-SQL 语句和查询。

• CLR 用户定义函数（包括表值函数）。

• CLR 用户定义类型。

• CLR 存储过程。

• CLR 触发器。

本白皮书说明如何使用 CLR 表值函数根据包括数据库在内的各种源创建报表数据，从

而创建可靠的 Reporting Services 报表。

使用 .NET Framework 扩展 Reporting Services 并集成 CLR 功能的方法有多种，其中包括以下方法：

• 传递扩展—传递报表来响应事件

• 呈现扩展—除 Reporting Services 支持的之外，还能以其他格式显示报表

• 安全扩展—提供您自己的身份验证和授权机制用于查看和管理报表

• 数据处理扩展—通过开发能够处理来自 Reporting Services 不支持的数据源的数据

• 自定义报表项—是自定义的服务器控件，可嵌入报表中，以提供除内置控件以外

的其他功能

本白皮书阐述如何实现表值函数来处理数据，使之成为使用数据处理扩展的替代方法。

有关扩展 Reporting Services 的详细信息，请参阅 SQL Server 2005 联机丛书中的 Reporting Services 扩展。

表值函数用于通过编程方式在运行时创建表。它们创建的表可象任何其他数据库表一

样用于 Transact-SQL 查询语句。在 SQL Server 2000 中引入表值函数时，只能使用 Transact-SQL 创建它们。以下是在 Transact-SQL 中实现的表值函数的示例。

CREATE function EmployeeNames()

returns @employeeNames table (id int, name nvarchar(20), )

as begin

INSERT @employeeNames values(1, 'Ryan');

INSERT @employeeNames values(2, 'John');

INSERT @employeeNames values(3, 'Bob');

return

end

然后，就可以从 select 语句中引用该函数，就象它是表一样：SELECT name from EmployeeNames() where id = 1。

查询返回以下值：

name

--------------------

Ryan

尽管这很有用，但还是受到 Transact-SQL 语言的限制，因为该语言主要应用于关系数据。如果您尝试离开其适用范围，那么 Transact-SQL 会变得多少有点不太灵活。在 SQL

Server 2005 中，您现在可以使用自己喜欢的 .NET Framework 语言来创建表值函数，这就可能出现一些令人惊叹的事情。现在，程序员能够将他们所需的任何信息提取到关系数据库

表中。

例如，以下代码是在 Microsoft Visual C# 中实现的 SQL Server 2005 表值函数，

它返回根据系统事件日志创建的表：

using System;

using System.Data.Sql;

using Microsoft.SqlServer.Server;

using System.Collections;

using System.Data.SqlTypes;

using System.Diagnostics;

public class TabularEventLog

{

[SqlFunction(TableDefinition="logTime

datetime,Message" +

"nvarchar(4000),Category

nvarchar(4000),InstanceId bigint",

Name="ReadEventLog", FillRowMethodName =

"FillRow")]

public static IEnumerable InitMethod(String logname)

{

return new EventLog(logname,

Environment.MachineName).Entries;

}

public static void FillRow(Object obj, out SqlDateTime

timeWritten,

out SqlChars message, out SqlChars category,

out long instanceId)

{

EventLogEntry eventLogEntry = (EventLogEntry)obj;

timeWritten = new

SqlDateTime(eventLogEntry.TimeWritten);

message = new SqlChars(eventLogEntry.Message);

category = new SqlChars(eventLogEntry.Category);

instanceId = eventLogEntry.InstanceId;

}

}

该表值函数是作为 TabularEventLog 类的两个静态方法实现的。第一个方法(InitMethod) 赋予 SqlFunction 属性，用于将它指定为该表值函数的入口点。此方法必须

返回 IEnumerable 或 IEnumerator 对象。该对象包含将用于填充返回表的数据。执行该函