Share via


방법: CLR SQL Server 사용자 정의 함수 만들기 및 실행

업데이트: 2007년 11월

사용자 정의 함수를 SQL Server 프로젝트에 추가하여 SQL 사용자 정의 함수를 만듭니다. 배포된 후에는 사용자 정의 함수를 호출하고 실행할 수 있습니다.

참고:

기본적으로 CLR(공용 언어 런타임) 통합 기능은 Microsoft SQL Server에서 해제되어 있으며 SQL Server 프로젝트 항목을 사용하려면 이 기능을 설정해야 합니다. CLR 통합 기능을 사용하도록 설정하려면 sp_configure 저장 프로시저의 clr enabled 옵션을 사용합니다. 자세한 내용은 CLR 통합 설정을 참조하십시오.

참고:

다음 지침처럼 컴퓨터에서 Visual Studio 사용자 인터페이스 요소 일부에 대한 이름이나 위치를 다르게 표시할 수 있습니다. 이러한 요소는 사용하는 Visual Studio 버전 및 설정에 따라 결정됩니다. 자세한 내용은 Visual Studio 설정을 참조하십시오.

SQL Server 사용자 정의 함수 만들기

Visual Studio를 사용하여 이 함수를 빌드하고 배포하려면

  1. 기존의 SQL Server 프로젝트를 열거나 새 프로젝트를 만듭니다. 자세한 내용은 방법: SQL Server 프로젝트 만들기를 참조하십시오.

  2. 프로젝트 메뉴에서 새 항목 추가를 선택합니다.

  3. 새 항목 추가 대화 상자에서 사용자 정의 함수를 선택합니다.

  4. 새 사용자 정의 함수의 이름을 입력합니다.

  5. 사용자 정의 함수가 실행될 경우 실행할 코드를 추가합니다. 이 절차 뒤의 첫 번째 예제를 참조하십시오.

    참고:

    C++ 예제는 /clr:safe 컴파일러 옵션을 사용하여 컴파일해야 합니다.

  6. Visual Basic 및 Visual C#의 경우 솔루션 탐색기에서 TestScripts 폴더를 열고 Test.sql 파일을 두 번 클릭하여 편집할 수 있도록 엽니다. 사용자 정의 함수를 실행하는 코드를 추가합니다. 이 절차 뒤의 두 번째 예제를 참조하십시오.

    Visual C++의 경우 솔루션 탐색기에서 debug.sql 파일을 두 번 클릭하여 편집할 수 있도록 엽니다. 사용자 정의 함수를 실행하는 코드를 추가합니다. 이 절차 뒤의 두 번째 예제를 참조하십시오.

  7. 사용자 정의 함수를 SQL Server에 배포합니다. 자세한 내용은 방법: SQL Server에 SQL Server 프로젝트 항목 배포를 참조하십시오.

  8. F5 키를 눌러 사용자 정의 함수를 SQL Server에서 실행하여 디버깅합니다.

설명

다음 코드 예제에서는 가격을 매개 변수로 받아들여 판매세를 더한 다음 가격과 판매세를 합한 금액을 반환하는 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;
    }
};

설명

프로젝트의 TestScripts 폴더에 있는 Test.sql(Visual C++의 경우 debug.sql) 파일에 사용자 정의 함수를 테스트하는 코드를 추가합니다. 예를 들어, 이 함수를 테스트하기 위해 "SELECT dbo.addTax(10)" 같은 쿼리를 사용합니다. "10.86" 값이 반환되는 것을 확인할 수 있습니다.

코드

SELECT dbo.addTax(10)

참고 항목

작업

방법: SQL Server 프로젝트 만들기

방법: CLR SQL Server 저장 프로시저 만들기 및 실행

방법: CLR SQL Server 트리거 만들기 및 실행

방법: CLR SQL Server 집계 만들기 및 실행

방법: CLR SQL Server 사용자 정의 함수 만들기 및 실행

방법: CLR SQL Server 사용자 정의 형식 만들기 및 실행

연습: 관리 코드로 저장 프로시저 만들기

방법: SQL CLR 저장 프로시저 디버깅

개념

SQL Server CLR 통합 소개

관리 코드를 사용하여 데이터베이스 개체를 만드는 경우의 이점

SQL Server 프로젝트에 대한 항목 템플릿

참조

SQL Server 프로젝트 및 데이터베이스 개체의 특성

기타 리소스

SQL CLR 데이터베이스 디버깅