사용자 정의 형식 만들기 - 요구 사항

  • 아티클

적용 대상:SQL Server

Microsoft SQL Server 설치할 UDT(사용자 정의 형식)를 만들 때 몇 가지 중요한 디자인 결정을 내려야 합니다. 대부분의 UDT는 구조로 만드는 것이 좋지만 클래스로 만드는 방법도 고려해 볼 수 있습니다. UDT 정의는 SQL Server 등록하려면 UDT를 만들기 위한 사양을 준수해야 합니다.

UDT 구현을 위한 요구 사항

SQL Server 실행하려면 UDT가 UDT 정의에서 다음 요구 사항을 구현해야 합니다.

UDT는 Microsoft.SqlServer.Server.SqlUserDefinedTypeAttribute를 지정해야 합니다. System.SerializableAttribute의 사용은 선택 사항이지만 권장됩니다.

  • UDT는 공용 정적(Microsoft Visual Basic에서 공유됨) Null 메서드를 만들어 클래스 또는 구조에서 System.Data.SqlTypes.INullable 인터페이스를 구현해야 합니다. SQL Server 기본적으로 null 인식입니다. 이 작업은 UDT를 실행하는 코드에서 Null 값을 인식할 수 있도록 하는 데 필요합니다.

  • UDT에는 에서 구문 분석을 지원하는 public static (또는 Shared) Parse 메서드와 개체의 문자열 표현으로 변환하기 위한 공용 ToString 메서드가 포함되어야 합니다.

  • 사용자 정의 serialization 형식의 UDT는 System.Data.IBinarySerialize 인터페이스를 구현하고 읽기 및 쓰기 메서드를 제공해야 합니다.

  • UDT는System.Xml 구현해야 합니다 . serialization.IXmlSerializable이거나, 표준 serialization을 재정의해야 하는 경우 모든 공용 필드 및 속성은 XML 직렬화 가능 또는 XmlIgnore 특성으로 데코레이트된 형식이어야 합니다.

  • UDT 개체의 직렬화가 하나만 있어야 합니다. 직렬화 또는 역직렬화 루틴에서 특정 개체의 표현을 두 개 이상 인식하면 유효성 검사가 실패합니다.

  • 데이터를 바이트 순서로 비교하려면 SqlUserDefinedTypeAttribute.IsByteOrdered가 true여야 합니다. IComparable 인터페이스가 구현되지 않고 SqlUserDefinedTypeAttribute.IsByteOrdered 가 false이면 바이트 순서 비교가 실패합니다.

  • 클래스에 정의된 UDT에는 인수를 사용하지 않는 공용 생성자가 있어야 합니다. 오버로드된 추가 클래스 생성자를 만들 수도 있습니다.

  • UDT가 데이터 요소를 공용 필드나 속성 프로시저로 표시해야 합니다.

  • 공용 이름은 128자를 초과할 수 없으며 데이터베이스 식별자에 정의된 식별자에 대한 SQL Server 명명 규칙을 준수해야 합니다.

  • sql_variant 열에는 UDT 인스턴스가 포함될 수 없습니다.

  • SQL Server 형식 시스템이 UDT 간의 상속 계층 구조를 인식하지 못하기 때문에 Transact-SQL에서 상속된 멤버에 액세스할 수 없습니다. 그러나 클래스를 구성할 때는 상속을 사용할 수 있으며 관리 코드를 사용한 형식 구현에서 이러한 메서드를 호출할 수 있습니다.

  • 클래스 생성자를 제외하고는 멤버를 오버로드할 수 없습니다. 오버로드된 메서드를 만드는 경우 어셈블리를 등록하거나 SQL Server 형식을 만들 때 오류가 발생하지 않습니다. 오버로드된 메서드는 형식이 만들어질 때가 아니라 런타임에 검색됩니다. 오버로드된 메서드를 호출하지 않는 한 오버로드된 메서드가 클래스 내에 존재할 수 있으며, 오버로드된 메서드를 호출하면 오류가 발생합니다.

  • 모든 정적 (또는 공유) 멤버는 상수 또는 읽기 전용으로 선언되어야 합니다. 정적 멤버는 변경할 수 없습니다.

  • SqlUserDefinedTypeAttribute.MaxByteSize 필드가 -1로 설정된 경우 직렬화된 UDT는 LOB(큰 개체) 크기 제한(현재 2GB)만큼 클 수 있습니다. UDT의 크기는 MaxByteSized 필드에 지정된 값을 초과할 수 없습니다.

참고

서버에서 비교를 수행하는 데 사용되지는 않지만 필요에 따라 단일 메서드 CompareTo를 노출하는 System.IComparable 인터페이스를 구현할 수 있습니다. 이 인터페이스는 UDT 값을 정확하게 비교하거나 정렬해야 하는 경우에 클라이언트 쪽에서 사용됩니다.

네이티브 직렬화

만들려는 UDT의 종류에 따라 UDT에 적합한 직렬화 특성을 선택해야 합니다. 네이티브 serialization 형식은 SQL Server 디스크에 UDT의 효율적인 네이티브 표현을 저장할 수 있는 매우 간단한 구조를 활용합니다. UDT가 단순하고 다음 형식의 필드만 포함하는 경우 네이티브 형식을 사용하는 것이 좋습니다.

bool, byte, sbyte, short, ushort, int, uint, long, ulong, float, double, SqlByte, SqlInt16, SqlInt32, SqlInt64, SqlDateTime, SqlSingle, SqlDouble, SqlMoney, SqlBoolean

위의 형식의 필드로 구성된 값 형식은 Visual C#의 구조체(또는 Visual Basic에서 알려진 구조체)와 같은 네이티브 형식에 적합한 후보입니다. 예를 들어 네이티브 serialization 형식으로 지정된 UDT에는 네이 티브 형식으로도 지정된 다른 UDT의 필드가 포함될 수 있습니다. UDT 정의가 더 복잡하고 위 목록에 없는 데이터 형식이 포함된 경우 대신 사용자 정의 serialization 형식을 지정해야 합니다.

네이티브 형식에는 다음과 같은 요구 사항이 있습니다.

  • 형식은 Microsoft.SqlServer.Server.SqlUserDefinedTypeAttribute.MaxByteSize에 대한 값을 지정해서는 안 됩니다.

  • 모든 필드를 직렬화할 수 있어야 합니다.

  • UDT가 구조체가 아닌 클래스에 정의된 경우 System.Runtime.InteropServices.StructLayoutAttribute 를 StructLayout.LayoutKindSequential 로 지정해야 합니다. 이 특성은 데이터 필드의 물리적 레이아웃을 제어하며 멤버를 멤버가 실제로 나타나는 순서대로 배치하는 데 사용됩니다. SQL Server 이 특성을 사용하여 여러 값이 있는 UDT의 필드 순서를 결정합니다.

네이티브 serialization으로 정의된 UDT의 예제는 코딩 User-Defined 형식의 점 UDT를 참조하세요.

UserDefined 직렬화

Microsoft.SqlServer.Server.SqlUserDefinedTypeAttribute 특성에 대한 사용자 정의 형식 설정은 개발자에게 이진 형식에 대한 모든 권한을 부여합니다. Format 특성 속성을 UserDefined로 지정할 때 코드에서 다음을 수행해야 합니다.

  • 선택적 IsByteOrdered 특성 속성을 지정합니다. 기본 값은 false입니다.

  • Microsoft.SqlServer.Server.SqlUserDefinedTypeAttribute의 MaxByteSize 속성을 지정합니다.

  • System.Data.Sql.IBinarySerialize 인터페이스를 구현하여 UDT에 대한 읽기 및 쓰기 메서드를 구현하는 코드를 작성합니다.

사용자 정의 직렬화로 정의된 UDT의 예제는 코딩 User-Defined 형식의 통화 UDT를 참조하세요.

참고

UDT 필드를 인덱싱하려면 UDT 필드에 네이티브 직렬화를 사용하거나 필드를 지속형 필드로 만들어야 합니다.

직렬화 특성

특성은 직렬화를 사용하여 UDT의 스토리지 표현을 생성하고 UDT를 값으로 클라이언트에 전송하는 방법을 결정합니다. UDT를 만들 때 Microsoft.SqlServer.Server.SqlUserDefinedTypeAttribute 를 지정해야 합니다. Microsoft.SqlServer.Server.SqlUserDefinedTypeAttribute 특성은 클래스가 UDT임을 나타내고 UDT에 대한 스토리지를 지정합니다. SQL Server 필요하지는 않지만 Serializable 특성을 선택적으로 지정할 수 있습니다.

Microsoft.SqlServer.Server.SqlUserDefinedTypeAttribute에는 다음과 같은 속성이 있습니다.

형식
UDT의 데이터 형식에 따라 Native 또는 UserDefined일 수 있는 serialization 형식을 지정합니다.

IsByteOrdered
SQL Server UDT에서 이진 비교를 수행하는 방법을 결정하는 부울 값입니다.

IsFixedLength
이 UDT의 모든 인스턴스 길이가 같은지 여부를 나타냅니다.

MaxByteSize
인스턴스의 최대 크기(바이트)입니다. 사용자 정의 serialization 형식으로 MaxByteSize를 지정해야 합니다. 사용자 정의 serialization이 지정된 UDT의 경우 MaxByteSize 는 사용자가 정의한 대로 직렬화된 형식의 UDT의 총 크기를 나타냅니다. MaxByteSize의 값은 1에서 8000 사이이거나 -1로 설정해야 UDT가 8000바이트보다 크다는 것을 나타냅니다(총 크기는 최대 LOB 크기를 초과할 수 없음). 문자열이 10자(System.Char)인 UDT를 고려합니다. BinaryWriter를 사용하여 UDT를 직렬화하면 직렬화된 문자열의 총 크기는 22바이트( 유니코드 UTF-16자당 2바이트)이며, 최대 문자 수와 이진 스트림을 serialize할 때 발생하는 2개의 제어 바이트 오버헤드를 곱합니다. 따라서 MaxByteSize 값을 결정할 때 직렬화된 UDT의 총 크기( 이진 형식으로 직렬화된 데이터의 크기와 직렬화로 인해 발생하는 오버헤드)를 고려해야 합니다.

ValidationMethodName
UDT의 인스턴스가 유효한지 여부를 검사하는 데 사용되는 메서드의 이름입니다.

IsByteOrdered 설정

Microsoft.SqlServer.Server.SqlUserDefinedTypeAttribute.IsByteOrdered 속성이 true로 설정되면 실제로 직렬화된 이진 데이터를 정보의 의미 체계 순서에 사용할 수 있습니다. 따라서 바이트 정렬된 UDT 개체의 각 인스턴스에는 직렬화된 표현이 하나만 포함될 수 있습니다. 직렬화된 바이트에서 SQL Server 비교 작업을 수행하는 경우 결과는 관리 코드에서 동일한 비교 작업이 수행된 경우와 동일해야 합니다. IsByteOrdered가 true로 설정된 경우에도 다음 기능이 지원됩니다.

  • 이 형식의 열에 인덱스를 만드는 기능

  • 이 형식의 열에 CHECK 및 UNIQUE 제약 조건과 기본 키 및 외래 키를 만드는 기능

  • Transact-SQL ORDER BY, GROUP BY 및 PARTITION BY 절을 사용하는 기능입니다. 이 경우 형식의 이진 표현이 순서를 결정하는 데 사용됩니다.

  • Transact-SQL 문에서 비교 연산자를 사용하는 기능입니다.

  • 이 형식의 계산 열을 유지하는 기능

IsByteOrdered가 true로 설정된 경우 네이티브 및 사용자 정의 serialization 형식은 모두 다음 비교 연산자를 지원합니다.

  • 같음(=)

  • 같지 않음(!=)

  • 보다 큼(>)

  • 보다 작음(<)

  • 보다 크거나 같음(>=)

  • 보다 작거나 같음(<=)

Null 허용 여부 구현

어셈블리의 특성을 올바르게 지정하는 것 외에도 클래스는 Null 허용 여부를 지원해야 합니다. SQL Server 로드된 UDT는 null을 인식하지만 UDT가 null 값을 인식하려면 클래스가 INullable 인터페이스를 구현해야 합니다. UDT에서 null 허용 여부를 구현하는 방법에 대한 자세한 내용과 예제는 User-Defined 형식 코딩을 참조하세요.

문자열 변환

UDT와의 문자열 변환을 지원하려면 클래스에 Parse 메서드와 ToString 메서드를 제공해야 합니다. Parse 메서드를 사용하면 문자열을 UDT로 변환할 수 있습니다. 정적(또는 Visual Basic에서 공유됨)으로 선언하고 System.Data.SqlTypes.SqlString 형식의 매개 변수를 사용해야 합니다. Parse 및 ToString 메서드를 구현하는 방법에 대한 자세한 내용과 예제는 User-Defined 형식 코딩을 참조하세요.

XML Serialization

UDT는 XML serialization 계약을 준수하여 xml 데이터 형식으로의 변환을 지원해야 합니다. System.Xml. Serialization 네임스페이스에는 개체를 XML 형식 문서 또는 스트림으로 직렬화하는 데 사용되는 클래스가 포함되어 있습니다. XML serialization 및 deserialization에 대한 사용자 지정 서식을 제공하는 IXmlSerializable 인터페이스를 사용하여 xml serialization을 구현하도록 선택할 수 있습니다.

XML serialization을 사용하면 UDT에서 xml로의 명시적 변환을 수행하는 것 외에도 다음을 수행할 수 있습니다.

  • xml 데이터 형식으로 변환한 후 UDT 인스턴스 값보다 Xquery를 사용합니다.

  • SQL Server 네이티브 XML Web Services를 사용하여 매개 변수가 있는 쿼리 및 웹 메서드에서 UDT를 사용합니다.

  • UDT를 사용하여 대량 로드된 XML 데이터를 받습니다.

  • UDT 열이 있는 테이블이 포함된 데이터 세트을 직렬화합니다.

FOR XML 쿼리에서는 UDT가 직렬화되지 않습니다. UDT의 XML serialization을 표시하는 FOR XML 쿼리를 실행하려면 각 UDT 열을 SELECT 문의 xml 데이터 형식으로 명시적으로 변환합니다. 열을 varbinary, varchar 또는 nvarchar로 명시적으로 변환할 수도 있습니다.

참고 항목

User-Defined 형식 만들기