방법: 공용 언어 런타임 통합을 사용하여 SQL Server 사용자 정의 형식 만들기 및 실행
사용자 정의 형식 항목을 SQL Server CLR(공용 언어 런타임) 데이터베이스 프로젝트에 추가하여 SQL 사용자 정의 형식을 만듭니다. 성공적으로 배포한 뒤에는 시스템 형식을 사용할 수 있는 모든 컨텍스트에서 이 형식을 사용할 수 있습니다. 이러한 컨텍스트에는 열 정의, 변수, 매개 변수, 함수 결과, 커서, 트리거, 복제 등이 있습니다. 사용자 정의 형식은 사용자에게 SQL Server 데이터 형식 시스템의 확장성을 제공하며 사용자가 복잡한 구조화된 형식을 정의할 수 있도록 합니다.
참고
다음 지침처럼 컴퓨터에서 Visual Studio 사용자 인터페이스 요소 일부에 대한 이름이나 위치를 다르게 표시할 수 있습니다. 이러한 요소는 사용하는 Visual Studio 버전 및 설정에 따라 결정됩니다. 자세한 내용은 Visual Studio 설정을 참조하십시오.
사용자 정의 형식 만들기
SQL 사용자 정의 형식을 만들려면
기존의 SQL CLR 데이터베이스 프로젝트를 열거나 새 프로젝트를 만듭니다. 자세한 내용은 방법: SQL Server 공용 언어 런타임 통합을 사용하는 데이터베이스 개체의 프로젝트 만들기을 참조하십시오.
프로젝트 메뉴에서 새 항목 추가를 선택합니다.
새 항목 추가 대화 상자에서 사용자 정의 형식을 선택합니다.
새 사용자 정의 형식의 이름을 입력합니다.
사용자 정의 형식을 정의하고 만드는 코드를 추가합니다. 이 절차 다음에 나오는 첫 번째 예제를 참조하십시오.
솔루션 탐색기에서 TestScripts 폴더를 열고 Test.sql 파일을 두 번 클릭합니다.
참고
다른 스크립트를 기본 디버그 스크립트로 지정할 수 있습니다. 자세한 내용은 방법: Test.sql 스크립트를 편집하여 SQL Server 공용 언어 런타임 통합을 사용하는 개체 실행을 참조하십시오.
Test.sql(Visual C++의 경우 debug.sql) 파일에 사용자 정의 형식을 실행하는 코드를 추가합니다. 이 절차 뒤의 두 번째 예제를 참조하십시오.
F5 키를 눌러 사용자 정의 형식을 빌드, 배포 및 디버깅합니다. 디버깅하지 않고 배포하는 방법에 대한 자세한 내용은 방법: SQL Server에 SQL CLR 데이터베이스 프로젝트 항목 배포를 참조하십시오.
중요
SQL Server 2005 및 SQL Server 2008에서는 .NET Framework 2.0, 3.0 또는 3.5 버전으로 빌드된 SQL Server 프로젝트만 지원합니다. 배포 하려고 하는 경우는 SQL Server 프로젝트를 SQL Server 2005 또는 SQL Server 2008, 오류 메시지가 나타납니다: Deploy error (SQL01268): .NET SqlClient Data Provider: Msg 6218, Level 16, State 3, Line 1 CREATE ASSEMBLY for assembly 'AssemblyName' failed because assembly 'AssemblyName' failed verification. Check if the referenced assemblies are up-to-date and trusted (for external_access or unsafe) to execute in the database(어디 AssemblyName 배포 하는 어셈블리의 이름입니다). 자세한 내용은 방법: SQL Server 공용 언어 런타임 통합을 사용하는 데이터베이스 개체의 프로젝트 만들기을 참조하십시오.
보기에 표시 된 결과 출력 창 선택 및 쇼에서 출력: 출력 데이터베이스.
예제
이 예제에서는 다른 단순 형식과 마찬가지 방법으로 사용할 수 있는 Point 형식을 만듭니다. 클래스 선언은 Serializable 및 SqlUserDefinedTypeAttribute 특성으로 데코레이팅됩니다. SqlUserDefinedTypeAttribute의 Format 속성에 따라 사용자 정의 형식의 저장소 형식이 결정됩니다. 이 형식은 Parse 및 ToString 메서드를 구현하여 문자열 변환을 구현합니다. 또한 이 클래스로 표현되는 점의 X 및 Y 값을 가져오고 설정하는 두 개의 속성 프로시저도 구현합니다.
Imports System
Imports System.Data.SqlTypes
Imports Microsoft.SqlServer.Server
<Serializable()>
<SqlUserDefinedType(Format.Native)>
Public Structure Point
Implements INullable
Private m_x As Int32
Private m_y As Int32
Private is_Null As Boolean
Public Property X() As Int32
Get
Return (Me.m_x)
End Get
Set(ByVal Value As Int32)
m_x = Value
End Set
End Property
Public Property Y() As Int32
Get
Return (Me.m_y)
End Get
Set(ByVal Value As Int32)
m_y = Value
End Set
End Property
Public ReadOnly Property IsNull() As Boolean Implements INullable.IsNull
Get
Return is_Null
End Get
End Property
Public Shared ReadOnly Property Null() As Point
Get
Dim pt As Point = New Point
pt.is_Null = True
Return pt
End Get
End Property
Public Overrides Function ToString() As String
If Me.IsNull() Then
Return Nothing
Else
Return Me.m_x & ":" & Me.m_y
End If
End Function
Public Shared Function Parse(ByVal s As SqlString) As Point
If s = SqlString.Null Then
Return Null
End If
If s.ToString() = SqlString.Null.ToString() Then
Return Null
End If
If s.IsNull Then
Return Null
End If
'Parse input string here to separate out coordinates
Dim str As String = Convert.ToString(s)
Dim xy() As String = str.Split(":"c)
Dim pt As New Point()
pt.X = CType(xy(0), Int32)
pt.Y = CType(xy(1), Int32)
Return (pt)
End Function
Public Function Quadrant() As SqlString
If m_x = 0 And m_y = 0 Then
Return "centered"
End If
Dim stringResult As String = ""
Select Case m_x
Case 0
stringResult = "center"
Case Is > 0
stringResult = "right"
Case Is < 0
stringResult = "left"
End Select
Select Case m_y
Case 0
stringResult = stringResult & " center"
Case Is > 0
stringResult = stringResult & " top"
Case Is < 0
stringResult = stringResult & " bottom"
End Select
Return stringResult
End Function
End Structure
using System;
using System.Data.SqlTypes;
using Microsoft.SqlServer.Server;
[Serializable()]
[SqlUserDefinedType(Format.Native)]
public struct Point : INullable
{
private Int32 m_x;
private Int32 m_y;
private bool is_Null;
public Int32 X
{
get
{
return (this.m_x);
}
set
{
m_x = value;
}
}
public Int32 Y
{
get
{
return (this.m_y);
}
set
{
m_y = value;
}
}
public bool IsNull
{
get
{
return is_Null;
}
}
public static Point Null
{
get
{
Point pt = new Point();
pt.is_Null = true;
return (pt);
}
}
public override string ToString()
{
if (this.IsNull)
{
return "NULL";
}
else
{
return this.m_x + ":" + this.m_y;
}
}
public static Point Parse(SqlString s)
{
if (s.IsNull)
{
return Null;
}
// Parse input string here to separate out coordinates
string str = Convert.ToString(s);
string[] xy = str.Split(':');
Point pt = new Point();
pt.X = Convert.ToInt32(xy[0]);
pt.Y = Convert.ToInt32(xy[1]);
return (pt);
}
public SqlString Quadrant()
{
if (m_x == 0 && m_y == 0)
{
return "centered";
}
SqlString stringReturn = "";
if (m_x == 0)
{
stringReturn = "center";
}
else if (m_x > 0)
{
stringReturn = "right";
}
else if (m_x < 0)
{
stringReturn = "left";
}
if (m_y == 0)
{
stringReturn = stringReturn + " center";
}
else if (m_y > 0)
{
stringReturn = stringReturn + " top";
}
else if (m_y < 0)
{
stringReturn = stringReturn + " bottom";
}
return stringReturn;
}
}
프로젝트의 TestScripts 폴더에 있는 Test.sql 파일에 사용자 정의 형식(Point)을 실행 및 테스트하는 코드를 추가합니다. 예를 들어, 새 형식을 검사하려면 이 형식을 사용하는 테이블을 만듭니다. 다음 예제에서는 테이블을 만들 때 Point 형식을 사용하는 방법을 보여 줍니다.
CREATE TABLE test_table (column1 Point)
go
INSERT INTO test_table (column1) VALUES ('1:2')
INSERT INTO test_table (column1) VALUES ('-2:3')
INSERT INTO test_table (column1) VALUES ('-3:-4')
select column1.Quadrant() from test_table
참고 항목
작업
방법: SQL Server 공용 언어 런타임 통합을 사용하는 데이터베이스 개체의 프로젝트 만들기
방법: 공용 언어 런타임 통합을 사용하여 SQL Server 저장 프로시저 만들기 및 실행
방법: 공용 언어 런타임 통합을 사용하여 SQL Server 트리거 만들기 및 실행
방법: 공용 언어 런타임 통합을 사용하여 SQL Server 집계 만들기 및 실행
방법: 공용 언어 런타임 통합을 사용하여 SQL Server 사용자 정의 함수 만들기 및 실행
참조
SQL CLR 데이터베이스 프로젝트 및 데이터베이스 개체의 특성
개념
관리 코드를 사용하여 데이터베이스 개체를 만드는 경우의 이점
SQLCLR 개체를 참조하는 데이터베이스의 팀 개발 시작