Практическое руководство. Создание и запуск пользовательской функции SQL Server в среде CLR

Статья
11/05/2008

Обновлен: Ноябрь 2007

Создайте пользовательскую функцию SQL путем добавления Пользовательской функции в проект SQL Server. После успешного развертывания пользовательские функции можно вызывать и выполнять.

Примечание.
Средства интеграции Microsoft SQL Server среды выполнения языка (CLR) по умолчанию отключены и должны быть включены для использования элементов проекта SQL Server. Для включения интеграции со средой CLR используйте параметр clr enabled хранимой процедуры sp_configure. Дополнительные сведения см. в разделе Включение интеграции со средой CLR.

Средства интеграции Microsoft SQL Server среды выполнения языка (CLR) по умолчанию отключены и должны быть включены для использования элементов проекта SQL Server. Для включения интеграции со средой CLR используйте параметр clr enabled хранимой процедуры sp_configure. Дополнительные сведения см. в разделе Включение интеграции со средой CLR.

Примечание.
На вашем компьютере названия некоторых элементов интерфейса пользователя Visual Studio или их расположение могут отличаться от указанных в нижеследующих инструкциях. Это зависит от имеющегося выпуска Visual Studio и используемых параметров. Дополнительные сведения см. в разделе Параметры Visual Studio.

На вашем компьютере названия некоторых элементов интерфейса пользователя Visual Studio или их расположение могут отличаться от указанных в нижеследующих инструкциях. Это зависит от имеющегося выпуска Visual Studio и используемых параметров. Дополнительные сведения см. в разделе Параметры 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.

Примечание.
Примеры C++ должны быть скомпилированы с параметром компилятора /clr:safe.

Описание

В следующем коде создается пользовательская скалярная функция с именем addTax, которая принимает цену в качестве параметра, добавляет налог с продаж и возвращает сумму цены и налога.

После создания функции разверните ее на SQL Server. Дополнительные сведения см. в разделе Практическое руководство. Развертывание элементов проекта SQL Server на сервере SQL Server.

Код

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;
    }
}

#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;
    }
};

Описание

Добавьте в файл Test.sql (debug.sql в Visual C++), находящийся в папке TestScripts проекта, код для тестирования пользовательской функции. Например, чтобы проверить эту функцию, используйте запрос "SELECT dbo.addTax(10)". Вы увидите возвращаемое значение "10,86".

Код

SELECT dbo.addTax(10)

См. также

Практическое руководство. Создание и запуск пользовательской функции SQL Server в среде CLR

Создание пользовательских функций в СУБД SQL Server

Чтобы создать и развернуть эту функцию, используя Visual Studio:

Описание

Код

Описание

Код

См. также

Задачи

Основные понятия

Ссылки

Другие ресурсы

Дополнительные ресурсы