사용자 정의 형식 사용
SQL Server 2005부터 UDT(사용자 정의 형식)가 도입되었습니다. UDT는 개체와 사용자 지정 데이터 구조를 SQL Server 데이터베이스에 저장할 수 있도록 SQL 유형 시스템을 확장합니다. UDT는 여러 데이터 형식과 동작이 포함될 수 있어 단일 SQL Server 시스템 데이터 형식으로 구성된 일반적인 별칭 데이터 형식과 차별화됩니다. UDT는 검증할 수 있는 코드를 생성하는 .NET CLR(공용 언어 런타임)에서 지원하는 모든 언어를 사용하여 정의합니다. 이러한 언어에는 Microsoft Visual C# 및 Visual Basic .NET 등이 있습니다. 데이터는 .NET 클래스 또는 구조체의 필드와 속성으로 노출되며 동작은 클래스 또는 구조체의 메서드로 정의됩니다.
UDT를 테이블의 열 정의, Transact-SQL 일괄 처리의 변수 또는 Transact-SQL 함수나 저장 프로시저의 인수로 사용할 수 있습니다.
SQL Server Native Client OLE DB Provider
SQL Server Native Client OLE DB Provider는 메타데이터 정보가 있는 이진 형식의 형태로 UDT를 지원하므로 UDT를 개체로 관리할 수 있습니다. UDT 열은 DBTYPE_UDT로 노출되고 해당 메타데이터는 핵심 OLE DB 인터페이스인 IColumnRowset와 새로운 ISSCommandWithParameters 인터페이스를 통해 노출됩니다.
[!참고]
IRowsetFind::FindNextRow 메서드는 UDT 데이터 형식과 함께 사용할 수 없습니다. UDT가 검색 열 유형으로 사용되는 경우 DB_E_BADCOMPAREOP가 반환됩니다.
데이터 바인딩 및 강제 변환
다음 표에서는 표의 데이터 형식을 SQL Server UDT와 함께 사용할 때 발생하는 바인딩 및 강제 변환에 대해 설명합니다. UDT 열은 SQL Server Native Client OLE DB Provider를 통해 DBTYPE_UDT로 노출됩니다. 적절한 스키마의 행 집합을 통해 메타데이터를 얻을 수 있으므로 사용자 정의 형식을 개체로 관리할 수 있습니다.
데이터 형식 |
SQL Server의 UDT |
SQL Server의 UDT 이외의 형식으로 바인딩 |
SQL Server의 UDT |
SQL Server의 UDT 이외의 형식으로 바인딩 |
|---|---|---|---|---|
DBTYPE_UDT |
지원됨6 |
오류1 |
지원됨6 |
오류5 |
DBTYPE_BYTES |
지원됨6 |
해당 없음2 |
지원됨6 |
해당 없음2 |
DBTYPE_WSTR |
지원됨3,6 |
해당 없음2 |
지원됨4,6 |
해당 없음2 |
DBTYPE_BSTR |
지원됨3,6 |
해당 없음2 |
지원됨4 |
해당 없음2 |
DBTYPE_STR |
지원됨3,6 |
해당 없음2 |
지원됨4,6 |
해당 없음2 |
DBTYPE_IUNKNOWN |
지원되지 않음 |
해당 없음2 |
지원되지 않음 |
해당 없음2 |
DBTYPE_VARIANT (VT_UI1 | VT_ARRAY) |
지원됨6 |
해당 없음2 |
지원됨4 |
해당 없음2 |
DBTYPE_VARIANT (VT_BSTR) |
지원됨3,6 |
해당 없음2 |
해당 없음 |
해당 없음2 |
1DBTYPE_UDT 이외의 서버 유형이 ICommandWithParameters::SetParameterInfo로 지정되고 접근자 유형이 DBTYPE_UDT인 경우 문을 실행하면 오류가 발생합니다(DB_E_ERRORSOCCURRED, 매개 변수 상태는 DBSTATUS_E_BADACCESSOR임). 그렇지 않은 경우에는 데이터가 서버로 전송되지만 UDT에서 매개 변수의 데이터 형식으로의 암시적 변환이 이루어지지 않았음을 나타내는 오류가 반환됩니다.
2이 항목에서는 다루지 않습니다.
3 16진수 문자열에서 이진 데이터로의 데이터 변환이 발생합니다.
4 이진 데이터에서 16진수 문자열로의 데이터 변환이 발생합니다.
5접근자 생성 시간 또는 인출 시간에 유효성 검사가 발생할 수 있습니다. 오류는 DB_E_ERRORSOCCURRED이고 바인딩 상태는 DBBINDSTATUS_UNSUPPORTEDCONVERSION으로 설정됩니다.
6BY_REF가 사용될 수 있습니다.
DBTYPE_NULL 및 DBTYPE_EMPTY는 입력 매개 변수에 대해서는 바인딩할 수 있지만 출력 매개 변수나 결과에 대해서는 바인딩할 수 없습니다. 입력 매개 변수에 대해 바인딩할 경우 상태를 DBSTATUS_S_ISNULL 또는 DBSTATUS_S_DEFAULT로 설정해야 합니다.
DBTYPE_UDT를 DBTYPE_EMPTY와 DBTYPE_NULL로 변환할 수 있지만 DBTYPE_NULL 및 DBTYPE_EMPTY는 DBTYPE_UDT로 변환할 수 없습니다. 이는 DBTYPE_BYTES와 일치합니다.
[!참고]
새 인터페이스는 UDT를 매개 변수인 ISSCommandWithParameters로 처리하는 데 사용됩니다. 이 매개 변수는 ICommandWithParameters에서 상속됩니다. 응용 프로그램은 이 인터페이스를 사용하여 UDT 매개 변수에 대해 적어도 DBPROPSET_SQLSERVERPARAMETER 속성 집합의 SSPROP_PARAM_UDT_NAME을 설정해야 합니다. 이 설정을 수행하지 않으면 ICommand::Execute가 DB_E_ERRORSOCCURRED를 반환합니다. 이 인터페이스와 속성 집합에 대해서는 이 항목의 뒷부분에서 설명합니다.
사용자 정의 형식이 크기가 작아 해당 형식의 모든 데이터를 유지할 수 없는 열에 삽입되는 경우 ICommand::Execute는 DB_E_ERRORSOCCURRED 상태와 함께 S_OK를 반환합니다.
OLE DB 핵심 서비스(IDataConvert)에서 제공하는 데이터 변환은 DBTYPE_UDT에는 적용되지 않습니다. 다른 바인딩은 지원되지 않습니다.
OLE DB 행 집합의 추가 내용 및 변경 내용
SQL Server Native Client는 많은 핵심 OLE DB 스키마 행 집합에 새로운 값이나 변경된 값을 추가합니다.
PROCEDURE_PARAMETERS 스키마 행 집합
PROCEDURE_PARAMETERS 스키마 행 집합에 다음이 추가되었습니다.
열 이름 |
유형 |
설명 |
|---|---|---|
SS_UDT_CATALOGNAME |
DBTYPE_WSTR |
세 부분으로 구성된 이름 식별자입니다. |
SS_UDT_SCHEMANAME |
DBTYPE_WSTR |
세 부분으로 구성된 이름 식별자입니다. |
SS_UDT_NAME |
DBTYPE_WSTR |
세 부분으로 구성된 이름 식별자입니다. |
SS_UDT_ASSEMBLY_TYPENAME |
DBTYPE_WSTR |
CLR이 참조하는 데 필요한 형식 이름과 모든 어셈블리 ID를 포함하는 어셈블리의 정규화된 이름입니다. |
SQL_ASSEMBLIES 스키마 행 집합
SQL Server Native Client OLE DB Provider는 등록된 UDT를 설명하는 새 공급자별 스키마 행 집합을 노출합니다. ASSEMBLY 서버가 DBTYPE_WSTR로 지정되지만 행 집합에는 없을 수 있습니다. 이 속성이 지정되지 않은 경우 행 집합은 기본적으로 현재 서버를 사용합니다. SQL_ASSEMBLIES 스키마 행 집합은 다음 표에 정의되어 있습니다.
열 이름 |
유형 |
설명 |
|---|---|---|
ASSEMBLY_CATALOG |
DBTYPE_WSTR |
형식을 포함하는 어셈블리의 카탈로그 이름입니다. |
ASSEMBLY_SCHEMA |
DBTYPE_WSTR |
형식을 포함하는 어셈블리의 스키마 이름 또는 소유자 이름입니다. 어셈블리 범위는 스키마가 아니라 데이터베이스에 의해 결정되지만 여전히 여기에서 나타내는 소유자를 가집니다. |
ASSEMBLY_NAME |
DBTYPE_WSTR |
형식을 포함하는 어셈블리의 이름입니다. |
ASSEMBLY_ID |
DBTYPE_UI4 |
형식을 포함하는 어셈블리의 개체 ID입니다. |
PERMISSION_SET |
DBTYPE_WSTR |
어셈블리의 액세스 범위를 나타내는 값입니다. 값에는 "SAFE", "EXTERNAL_ACCESS" 및 "UNSAFE"가 포함됩니다. |
ASSEMBLY_BINARY |
DBTYPE_BYTES |
어셈블리의 이진 표현입니다. |
SQL_ASSEMBLIES_ DEPENDENCIES 스키마 행 집합
SQL Server Native Client OLE DB Provider는 지정된 서버의 어셈블리 종속성을 설명하는 새 공급자별 스키마 행 집합을 노출합니다. ASSEMBLY_SERVER가 호출자에 의해 DBTYPE_WSTR로 지정되지만 행 집합에는 없을 수 있습니다. 이 속성이 지정되지 않은 경우 행 집합은 기본적으로 현재 서버를 사용합니다. SQL_ASSEMBLY_DEPENDENCIES 스키마 행 집합은 다음 표에 정의되어 있습니다.
열 이름 |
유형 |
설명 |
|---|---|---|
ASSEMBLY_CATALOG |
DBTYPE_WSTR |
형식을 포함하는 어셈블리의 카탈로그 이름입니다. |
ASSEMBLY_SCHEMA |
DBTYPE_WSTR |
형식을 포함하는 어셈블리의 스키마 이름 또는 소유자 이름입니다. 어셈블리 범위는 스키마가 아니라 데이터베이스에 의해 결정되지만 여전히 여기에서 나타내는 소유자를 가집니다. |
ASSEMBLY_ID |
DBTYPE_UI4 |
어셈블리의 개체 ID입니다. |
REFERENCED_ASSEMBLY_ID |
DBTYPE_UI4 |
참조된 어셈블리의 개체 ID입니다. |
SQL_USER_TYPES 스키마 행 집합
SQL Server Native Client OLE DB Provider는 새 스키마 행 집합인 SQL_USER_TYPES를 노출합니다. 이 행 집합은 지정된 서버의 등록된 UDT가 추가되는 시점을 설명합니다. UDT_SERVER가 호출자에 의해 DBTYPE_WSTR로 지정되어야 하지만 행 집합에는 없을 수 있습니다. SQL_USER_TYPES 스키마 행 집합은 다음 표에 정의되어 있습니다.
열 이름 |
유형 |
설명 |
|---|---|---|
UDT_CATALOGNAME |
DBTYPE_WSTR |
UDT 열의 경우 이 속성이 UDT가 정의되어 있는 카탈로그의 이름을 지정하는 문자열입니다. |
UDT_SCHEMANAME |
DBTYPE_WSTR |
UDT 열의 경우 이 속성이 UDT가 정의되어 있는 스키마의 이름을 지정하는 문자열입니다. |
UDT_NAME |
DBTYPE_WSTR |
UDT 클래스가 포함된 어셈블리의 이름입니다. |
UDT_ASSEMBLY_TYPENAME |
DBTYPE_WSTR |
전체 형식 이름(AQN)은 적용 가능한 경우 네임스페이스에 따른 접두사가 추가된 형식 이름을 포함합니다. |
COLUMNS 스키마 행 집합
COLUMNS 스키마 행 집합에 추가된 열은 다음과 같습니다.
열 이름 |
유형 |
설명 |
|---|---|---|
SS_UDT_CATALOGNAME |
DBTYPE_WSTR |
UDT 열의 경우 이 속성이 UDT가 정의되어 있는 카탈로그의 이름을 지정하는 문자열입니다. |
SS_UDT_SCHEMANAME |
DBTYPE_WSTR |
UDT 열의 경우 이 속성이 UDT가 정의되어 있는 스키마의 이름을 지정하는 문자열입니다. |
SS_UDT_NAME |
DBTYPE_WSTR |
UDT의 이름입니다. |
SS_UDT_ASSEMBLY_TYPENAME |
DBTYPE_WSTR |
전체 형식 이름(AQN)은 적용 가능한 경우 네임스페이스에 따른 접두사가 추가된 형식 이름을 포함합니다. |
OLE DB 속성 집합의 추가 내용 및 변경 내용
SQL Server Native Client는 많은 핵심 OLE DB 속성 집합에 새로운 값이나 변경된 값을 추가합니다.
DBPROPSET_SQLSERVERPARAMETER 속성 집합
OLE DB를 통해 UDT를 지원하기 위해 SQL Server Native Client는 다음 값이 포함된 새로운 DBPROPSET_SQLSERVERPARAMETER 속성 집합을 구현합니다.
이름 |
유형 |
설명 |
|---|---|---|
SSPROP_PARAM_UDT_CATALOGNAME |
DBTYPE_WSTR |
세 부분으로 구성된 이름 식별자입니다. UDT 매개 변수의 경우 이 속성이 사용자 정의 형식이 정의되어 있는 카탈로그의 이름을 지정하는 문자열입니다. |
SSPROP_PARAM_UDT_SCHEMANAME |
DBTYPE_WSTR |
세 부분으로 구성된 이름 식별자입니다. UDT 매개 변수의 경우 이 속성이 사용자 정의 형식이 정의되어 있는 스키마의 이름을 지정하는 문자열입니다. |
SSPROP_PARAM_UDT_NAME |
DBTYPE_WSTR |
세 부분으로 구성된 이름 식별자입니다. UDT 열의 경우 이 속성이 사용자 정의 형식의 단일 부분으로 구성된 이름을 지정하는 문자열입니다. |
SSPROP_PARAM_UDT_NAME은 필수입니다. SSPROP_PARAM_UDT_CATALOGNAME 및 SSPROP_PARAM_UDT_SCHEMANAME은 옵션입니다. 이러한 속성 중 하나가 잘못 지정되면 DB_E_ERRORSINCOMMAND가 반환됩니다. SSPROP_PARAM_UDT_CATALOGNAME 및 SSPROP_PARAM_UDT_SCHEMANAME이 모두 지정되지 않은 경우 테이블과 동일한 데이터베이스와 스키마에서 UDT를 정의해야 합니다. UDT 정의가 테이블과 동일한 데이터베이스에 속하지만 다른 스키마에 속하는 경우 SSPROP_PARAM_UDT_SCHEMANAME을 지정해야 합니다. UDT 정의가 다른 데이터베이스에 속하는 경우 SSPROP_PARAM_UDT_CATALOGNAME 및 SSPROP_PARAM_UDT_SCHEMANAME을 모두 지정해야 합니다.
DBPROPSET_SQLSERVERCOLUMN 속성 집합
ITableDefinition 인터페이스를 통한 테이블 생성을 지원하기 위해 SQL Server Native Client는 DBPROPSET_SQLSERVERCOLUMN 속성 집합에 다음과 같은 세 개의 새로운 열을 추가합니다.
이름 |
설명 |
유형 |
설명 |
|---|---|---|---|
SSPROP_COL_UDT_CATALOGNAME |
UDT_CATALOGNAME |
VT_BSTR |
DBTYPE_UDT 형식인 열의 경우 이 속성이 UDT가 정의되어 있는 카탈로그의 이름을 지정하는 문자열입니다. |
SSPROP_COL_UDT_SCHEMANAME |
UDT_SCHEMANAME |
VT_BSTR |
DBTYPE_UDT 형식인 열의 경우 이 속성이 UDT가 정의되어 있는 스키마의 이름을 지정하는 문자열입니다. |
SSPROP_COL_UDT_NAME |
UDT_NAME |
VT_BSTR |
DBTYPE_UDT 형식인 열의 경우 이 속성이 UDT의 단일 부분으로 구성된 이름을 지정하는 문자열입니다. 다른 열 유형에 대해서는 이 속성이 빈 문자열을 반환합니다. |
[!참고]
PROVIDER_TYPES 스키마 행 집합에는 UDT가 나타나지 않습니다. 모든 열에 읽기 및 쓰기 액세스가 있습니다.
ADO는 설명 열의 해당 항목을 사용하여 이러한 속성을 참조합니다.
SSPROP_COL_UDTNAME은 필수입니다. SSPROP_COL_UDT_CATALOGNAME 및 SSPROP_COL_UDT_SCHEMANAME은 옵션입니다. 이러한 속성 중 하나가 잘못 지정되면 DB_E_ERRORSINCOMMAND가 반환됩니다.
SSPROP_COL_UDT_CATALOGNAME 및 SSPROP_COL_UDT_SCHEMANAME이 모두 지정되지 않은 경우 테이블과 동일한 데이터베이스와 스키마에서 UDT를 정의해야 합니다.
UDT 정의가 테이블과 동일한 데이터베이스에 속하지만 다른 스키마에 속하는 경우 SSPROP_COL_UDT_SCHEMANAME을 지정해야 합니다.
UDT 정의가 다른 데이터베이스에 속하는 경우 SSPROP_COL_UDT_CATALOGNAME 및 SSPROP_COL_UDT_SCHEMANAME을 모두 지정해야 합니다.
OLE DB 인터페이스의 추가 내용 및 변경 내용
SQL Server Native Client는 많은 핵심 OLE DB 인터페이스에 새로운 값이나 변경된 값을 추가합니다.
ISSCommandWithParameters 인터페이스
OLE DB를 통해 UDT를 지원하기 위해 SQL Server Native Client는 ISSCommandWithParameters 인터페이스의 추가를 비롯하여 많은 변경을 구현합니다. 이 새 인터페이스는 핵심 OLE DB 인터페이스인 ICommandWithParameters에서 상속됩니다. ICommandWithParameters에서 상속되는 세 개의 메서드인 GetParameterInfo, MapParameterNames 및 SetParameterInfo 외에도 ISSCommandWithParameters는 서버 데이터 형식을 처리하는 데 사용되는 GetParameterProperties 및 SetParameterProperties 메서드를 제공합니다.
[!참고]
또한 ISSCommandWithParameters 인터페이스는 새로운 SSPARAMPROPS 구조를 사용합니다.
IColumnsRowset 인터페이스
ISSCommandWithParameters 인터페이스 이외에도 SQL Server Native Client는 IColumnsRowset::GetColumnRowset 메서드를 호출하여 반환되는 행 집합에 다음을 비롯한 새 값을 추가합니다.
열 이름 |
유형 |
설명 |
|---|---|---|
DBCOLUMN_SS_UDT_CATALOGNAME |
DBTYPE_WSTR |
UDT 카탈로그 이름 식별자입니다. |
DBCOLUMN_SS_UDT_SCHEMANAME |
DBTYPE_WSTR |
UDT 스키마 이름 식별자입니다. |
DBCOLUMN_SS_UDT_NAME |
DBTYPE_WSTR |
UDT 이름 식별자입니다. |
DBCOLUMN_SS_ASSEMBLY_TYPENAME |
DBTYPE_WSTR |
CLR이 참조하는 데 필요한 형식 이름과 모든 어셈블리 ID를 포함하는 어셈블리의 정규화된 이름입니다. |
DBCOLUMN_TYPE이 DBTYPE_UDT로 설정되어 있는 경우 위에 지정된 추가적인 UDT 메타데이터를 찾아 서버의 UDT 열을 다른 이진 형식과 구분할 수 있습니다. 해당 데이터가 부분적으로 완료된 경우 서버 유형은 UDT입니다. 비 UDT 서버 유형의 경우에는 이러한 열이 항상 NULL로 반환됩니다.
SQL Server Native Client ODBC 드라이버
UDT를 지원할 수 있도록 SQL Server Native Client ODBC 드라이버에서 많은 변경이 있었습니다. SQL Server Native Client ODBC 드라이버는 SQL Server UDT를 SQL_SS_UDT 드라이버별 SQL 데이터 형식 식별자에 매핑합니다. UDT 열은 SQL_SS_UDT로 표시됩니다. UDT의 ToString 또는 ToXMLString 메서드를 사용하거나 CAST/CONVERT 함수를 통해 UDT 열을 명시적으로 SQL 문의 다른 형식에 매핑한 경우 결과 집합의 열 유형은 해당 열이 변환된 실제 형식을 반영합니다.
SQLColAttribute, SQLDescribeParam, SQLGetDescField
결과 집합의 UDT 열이나 SQLColAttribute, SQLDescribeParam 및 SQLGetDescField 함수를 통해 검색되는 저장 프로시저/매개 변수가 있는 쿼리의 UDT 매개 변수에 대한 추가 정보를 제공하기 위해 새 드라이버별 설명자 필드 네 개가 추가되었습니다.
추가된 새 설명자 필드 네 개는 SQL_CA_SS_UDT_CATALOG_NAME, SQL_CA_SS_UDT_SCHEMA_NAME, SQL_CA_SS_UDT_TYPE_NAME 및 SQL_CA_SS_UDT_ASSEMBLY_TYPE_NAME입니다.
SQLColumns, SQLProcedureColumns
또한 UDT 결과 집합 열이나 UDT 매개 변수에 대한 추가 정보를 제공하기 위해 SQLColumns 및 SQLProcedureColumns 함수에서 반환되는 결과 집합에 새 드라이버별 열 세 개가 추가되었습니다. 이 새로운 세 개의 열은 SS_UDT_CATALOG_NAME, SS_UDT_SCHEMA_NAME 및 SS_UDT_ASSEMBLY_TYPE_NAME입니다.
지원되는 변환
SQL에서 C 데이터 형식으로 변환할 때 SQL_C_WCHAR, SQL_C_BINARY 및 SQL_C_CHAR을 모두 SQL_SS_UDT로 변환할 수 있습니다. 하지만 SQL_C_WCHAR 및 SQL_C_CHAR SQL 데이터 형식에서 변환할 경우에는 이진 데이터가 16진수 문자열로 변환됩니다.
C에서 SQL 데이터 형식으로 변환할 때 SQL_C_WCHAR, SQL_C_BINARY 및 SQL_C_CHAR을 모두 SQL_SS_UDT로 변환할 수 있습니다. 하지만 SQL_C_WCHAR 및 SQL_C_CHAR SQL 데이터 형식에서 변환할 경우에는 이진 데이터가 16진수 문자열로 변환됩니다.
참고 항목
참조
ISSCommandWithParameters(OLE DB)