2012-08-03

如何：创建和运行 CLR SQL Server 用户定义的函数

1966
0
SQLSERVER

摘要:如何：创建和运行 CLR SQL Server 用户定义的函数

通过向 SQL Server 项目添加“用户定义函数”创建用户定义的 SQL 函数。部署成功后，可调用并执行用户定义的函数。

注意
在默认情况下，Microsoft SQL Server 中关闭了公共语言运行库 (CLR) 集成功能。必须启用该功能才能使用 SQL Server 项目项。若要启用 CLR 集成，请使用 sp_configure 存储过程的“启用 clr”选项。有关更多信息，请参见启用 CLR 集成。

注意
显示的对话框和菜单命令可能会与帮助中的描述不同，具体取决于您现用的设置或版本。若要更改设置，请在“工具”菜单上选择“导入和导出设置”。有关更多信息，请参见 Visual Studio 设置。

创建用户定义的 SQL Server 函数

使用 Visual Studio 建立和部署此函数

打开一个现有的“SQL Server 项目”，或者创建一个新项目。有关更多信息，请参见如何：创建 SQL Server 项目。
从“项目”菜单中选择“添加新项”。
在“添加新项”对话框中选择“用户定义函数”。
键入新用户定义函数的“名称”。
添加执行用户定义函数时运行的代码。请参见下面的第一个示例。

注意
C++ 示例在编译时必须使用 /clr:safe 编译器选项。

对于 Visual Basic 和 Visual C#，在“解决方案资源管理器”中，打开“TestScripts”文件夹，然后双击“Test.sql”文件，以打开它进行编辑。添加执行您的用户定义函数的代码。请参见下面的第二个示例。

对于 Visual C++，在“解决方案资源管理器”中双击“debug.sql”文件，以打开它进行编辑。添加执行您的用户定义函数的代码。请参见下面的第二个示例。
将用户定义函数部署到 SQL Server。有关更多信息，请参见如何：将 SQL Server 项目项部署到 SQL Server 中。
按 F5 通过在 SQL Server 上执行用户定义的函数来对其进行调试。

下面的代码示例创建用户定义的将价格作为参数的标量函数 addTax，添加销售税并返回价格和销售税的加和。

创建该函数后，将其部署到 SQL Server。有关更多信息，请参见如何：将 SQL Server 项目项部署到 SQL Server 中

Visual Basic

Imports System.Data.SqlTypes
Imports Microsoft.SqlServer.Server

Partial Public Class UserDefinedFunctions

    Public Const SALES_TAX As Double = 0.086

    <SqlFunction()> _
    Public Shared Function addTax(ByVal originalAmount As SqlDouble) As SqlDouble

        Dim taxAmount As SqlDouble = originalAmount * SALES_TAX

        Return originalAmount + taxAmount
    End Function
End Class

using System.Data.SqlTypes;
using Microsoft.SqlServer.Server;

public partial class UserDefinedFunctions
{
    public const double SALES_TAX = .086;

    [SqlFunction()]
    public static SqlDouble addTax(SqlDouble originalAmount)
    {
        SqlDouble taxAmount = originalAmount * SALES_TAX;

        return originalAmount + taxAmount;
    }
}

C++

#include "stdafx.h"

#using <System.dll>
#using <System.Data.dll>
#using <System.Xml.dll>

using namespace System;
using namespace System::Data;
using namespace System::Data::Sql;
using namespace System::Data::SqlTypes;
using namespace Microsoft::SqlServer::Server;

// In order to debug your Aggregate, add the following to your debug.sql file:
//
// SELECT dbo.addTax(10)
//

public ref class UserDefinedFunctions
{
public:
    static initonly double SALES_TAX = 0.086;

    [SqlFunction()]
    static SqlDouble AddTax(SqlDouble originalAmount)
    {
        SqlDouble taxAmount = originalAmount * SALES_TAX;

        return originalAmount + taxAmount;
    }
};

向您的项目中 TestScripts 文件夹中的 Test.sql（在　Visual C++ 中为 debug.sql）文件，添加用于测试用户定义函数的代码。例如，若要测试此函数，请使用查询，如“SELECT dbo.addTax(10)”。您应见到返回的值“10.86”。

SELECT dbo.addTax(10)

请参见

创建用户定义的 SQL Server 函数

使用 Visual Studio 建立和部署此函数

请参见

任务

参考

概念

其他资源