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

CLR 集成的机制有多种：

• CLR 用户定义函数（包括表值函数）。
• CLR 用户定义类型。
• CLR 存储过程。
• CLR 触发器。

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

扩展 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 对象。该对象包含将用于填充返回表的数据。执行该函数时，SQL Server 将循环访问 IEnumerator 对象中的每个对象，并使用它来填充数据行。为此，它要将该对象传递到该类中的第二个方法 FillRow。此方法会将该对象转换成返回表中的某一行。此方法在 SqlFunction 属性的 FillRowMethodName 参数中指定。