如何:創(chuàng)建和運行 CLR SQL Server 用戶定義的函數(shù)
通過向 SQL Server 項目添加“用戶定義函數(shù)”創(chuàng)建用戶定義的 SQL 函數(shù)。部署成功后,可調(diào)用并執(zhí)行用戶定義的函數(shù)。
注意; 在默認(rèn)情況下,Microsoft SQL Server 中關(guān)閉了公共語言運行庫 (CLR) 集成功能。必須啟用該功能才能使用 SQL Server 項目項。若要啟用 CLR 集成,請使用 sp_configure 存儲過程的“啟用 clr”選項。有關(guān)更多信息,請參見啟用 CLR 集成。注意; 顯示的對話框和菜單命令可能會與幫助中的描述不同,具體取決于您現(xiàn)用的設(shè)置或版本。若要更改設(shè)置,請在“工具”菜單上選擇“導(dǎo)入和導(dǎo)出設(shè)置”。有關(guān)更多信息,請參見 Visual Studio 設(shè)置。
創(chuàng)建用戶定義的 SQL Server 函數(shù)使用 Visual Studio 建立和部署此函數(shù)打開一個現(xiàn)有的“SQL Server 項目”,或者創(chuàng)建一個新項目。有關(guān)更多信息,請參見如何:創(chuàng)建 SQL Server 項目。
從“項目”菜單中選擇“添加新項”。
在“添加新項”對話框 中選擇“用戶定義函數(shù)”。
鍵入新用戶定義函數(shù)的“名稱”。
添加執(zhí)行用戶定義函數(shù)時運行的代碼。請參見下面的第一個示例。
注意; C++ 示例在編譯時必須使用 /clr:safe 編譯器選項。
對于 Visual Basic 和 Visual C#,在“解決方案資源管理器”中,打開“TestScripts”文件夾,然后雙擊“Test.sql”文件,以打開它進行編輯。添加執(zhí)行您的用戶定義函數(shù)的代碼。請參見下面的第二個示例。
對于 Visual C++,在“解決方案資源管理器”中雙擊“debug.sql”文件,以打開它進行編輯。添加執(zhí)行您的用戶定義函數(shù)的代碼。請參見下面的第二個示例。
將用戶定義函數(shù)部署到 SQL Server。有關(guān)更多信息,請參見如何:將 SQL Server 項目項部署到 SQL Server 中。
按 F5 通過在 SQL Server 上執(zhí)行用戶定義的函數(shù)來對其進行調(diào)試。
下面的代碼示例創(chuàng)建用戶定義的將價格作為參數(shù)的標(biāo)量函數(shù) addTax,添加銷售稅并返回價格和銷售稅的加和。
創(chuàng)建該函數(shù)后,將其部署到 SQL Server。有關(guān)更多信息,請參見如何:將 SQL Server 項目項部署到 SQL Server 中
Visual Basic 復(fù)制代碼Imports System.Data.SqlTypesImports 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 FunctionEnd ClassC# 復(fù)制代碼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++ 復(fù)制代碼#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)文件,添加用于測試用戶定義函數(shù)的代碼。例如,若要測試此函數(shù),請使用查詢,如“SELECT dbo.addTax(10)”。您應(yīng)見到返回的值“10.86”。
復(fù)制代碼SELECT dbo.addTax(10)
