큰 CLR 사용자 정의 형식(OLE DB)
이 항목에서는 큰 CLR(공용 언어 런타임) UDT(사용자 정의 형식)를 지원하기 위한 SQL Server Native Client의 OLE DB 변경 내용에 대해 설명합니다.
SQL Server Native Client의 큰 CLR UDT 지원에 대한 자세한 내용은 큰 CLR 사용자 정의 형식을 참조하십시오.
데이터 형식
SQL Server Native Client는 ~0을 사용하여 LOB(Large Object) 형식에 대해 무제한 크기인 값의 길이를 나타냅니다. SQL Server 2008부터 ~0은 8,000바이트보다 큰 CLR UDT 크기도 나타냅니다.
다음 표에서는 매개 변수 및 행 집합의 데이터 형식 매핑을 보여 줍니다.
SQL Server 데이터 형식 |
@FSHO10@OLE DB 데이터 형식 |
@FSHO10@메모리 레이아웃 |
값 |
|---|---|---|---|
@FSHO10@CLR UDT |
DBTYPE_UDT |
BYTE[](바이트 배열) |
@FSHO10@132(oledb.h) |
UDT 값은 바이트 배열로 나타납니다. 16진수 문자열로의 변환 및 그 반대의 변환이 지원됩니다. 리터럴 값은 접두사 "0x"를 사용하여 16진수 문자열로 나타납니다. 16진수 문자열은 밑수가 16인 이진 데이터의 텍스트 표현입니다. 예를 들어 서버 형식 varbinary(10)를 DBTYPE_STR로 변환하는 경우 모든 문자 쌍이 단일 바이트를 나타내는 20자의 16진수 표현이 생성됩니다.
ITableDefinition::CreateTable의 데이터 형식 매핑
UDT 열이 필요한 경우 ITableDefinition::CreateTable에서 사용하는 DBCOLUMNDESC 구조에 사용되는 정보는 다음과 같습니다.
OLE DB 데이터 형식(wType) |
pwszTypeName |
SQL Server 데이터 형식 |
rgPropertySets |
|---|---|---|---|
DBTYPE_UDT |
무시됨 |
UDT |
DBPROPSET_SQLSERVERCOLUMN 속성 집합을 포함해야 합니다. |
@FSHO10@ICommandWithParameters::GetParameterInfo
prgParamInfo를 통해 DBPARAMINFO 구조에 반환된 정보는 다음과 같습니다.
@FSHO10@매개 변수 유형 |
wType |
ulParamSize |
bPrecision |
bScale |
dwFlags DBPARAMFLAGS_ISLONG |
|---|---|---|---|---|---|
DBTYPE_UDT @FSHO10@(8,000바이트 이하 길이) |
"DBTYPE_UDT" |
n |
@FSHO10@정의되지 않음 |
@FSHO10@정의되지 않음 |
clear |
DBTYPE_UDT @FSHO10@(8,000바이트를 초과하는 길이) |
"DBTYPE_UDT" |
~0 |
@FSHO10@정의되지 않음 |
@FSHO10@정의되지 않음 |
set |
ICommandWithParameters::SetParameterInfo
DBPARAMBINDINFO 구조에 제공된 정보는 다음을 준수해야 합니다.
@FSHO10@매개 변수 유형 |
pwszDataSourceType |
ulParamSize |
bPrecision |
bScale |
dwFlags DBPARAMFLAGS_ISLONG |
|---|---|---|---|---|---|
DBTYPE_UDT @FSHO10@(8,000바이트 이하 길이) |
DBTYPE_UDT |
n |
@FSHO10@무시됨 |
@FSHO10@무시됨 |
DBTYPE_IUNKNOWN을 사용하여 매개 변수가 전달되는 경우 설정해야 합니다. |
DBTYPE_UDT @FSHO10@(8,000바이트를 초과하는 길이) |
DBTYPE_UDT |
~0 |
@FSHO10@무시됨 |
@FSHO10@무시됨 |
@FSHO10@무시됨 |
ISSCommandWithParameters
응용 프로그램에서 ISSCommandWithParameters를 사용하여 매개 변수 속성 섹션에서 정의된 매개 변수 속성을 가져오고 설정합니다.
@FSHO10@IColumnsRowset::GetColumnsRowset
반환되는 열은 다음과 같습니다.
열 유형 |
@FSHO10@DBCOLUMN_TYPE |
DBCOLUMN_COLUMNSIZE |
@FSHO10@DBCOLUMN_PRECISION |
DBCOLUMN_SCALE |
DBCOLUMN_FLAGS_ISLONG |
DBCOLUMNS_ISSEARCHABLE |
DBCOLUMN_OCTETLENGTH |
|---|---|---|---|---|---|---|---|
DBTYPE_UDT @FSHO10@(8,000바이트 이하 길이) |
DBTYPE_UDT |
n |
@FSHO1@NULL |
@FSHO1@NULL |
Clear |
DB_ALL_EXCEPT_LIKE |
n |
DBTYPE_UDT @FSHO10@(8,000바이트를 초과하는 길이) |
DBTYPE_UDT |
~0 |
@FSHO1@NULL |
@FSHO1@NULL |
Set |
DB_ALL_EXCEPT_LIKE |
0 |
UDT에 대해 다음 열도 정의됩니다.
열 식별자 |
유형 |
설명 |
|---|---|---|
DBCOLUMN_UDT_CATALOGNAME |
DBTYPE_WSTR |
UDT 열의 경우 UDT가 정의된 카탈로그의 이름입니다. |
DBCOLUMN_UDT_SCHEMANAME |
DBTYPE_WSTR |
UDT 열의 경우 UDT가 정의된 스키마의 이름입니다. |
DBCOLUMN_UDT_NAME |
DBTYPE_WSTR |
UDT 열의 경우 UDT의 단일 부분 이름입니다. |
DBCOLUMN_ASSEMBLY_TYPENAME |
DBTYPE_WSTR |
UDT 열의 경우 UDT의 전체 유형 이름입니다. 어셈블리 유형의 정규화된 이름을 사용하면 Type.GetType 메서드를 사용하여 해당 유형의 개체를 인스턴스화할 수 있습니다. |
IColumnsInfo::GetColumnInfo
DBCOLUMNINFO 구조에 반환되는 정보는 다음과 같습니다.
@FSHO10@매개 변수 유형 |
wType |
ulColumnSize |
bPrecision |
bScale |
dwFlags @FSHO10@DBCOLUMNFLAGS_ISLONG |
|---|---|---|---|---|---|
DBTYPE_UDT @FSHO10@(8,000바이트 이하 길이) |
DBTYPE_UDT |
n |
~0 |
~0 |
Clear |
DBTYPE_UDT @FSHO10@(8,000바이트를 초과하는 길이) |
DBTYPE_UDT |
~0 |
~0 |
~0 |
Set |
COLUMNS 행 집합(스키마 행 집합)
UDT 유형에 대해 다음 열 값이 반환됩니다.
열 유형 |
DATA_TYPE |
COLUMN_FLAGS, DBCOLUMFLAGS_ISLONG |
CHARACTER_OCTET_LENGTH |
|---|---|---|---|
DBTYPE_UDT @FSHO10@(8,000바이트 이하 길이) |
DBTYPE_UDT |
Clear |
n |
DBTYPE_UDT @FSHO10@(8,000바이트를 초과하는 길이) |
DBTYPE_UDT |
Set |
0 |
UDT에 대해 다음 추가 열이 정의됩니다.
열 식별자 |
유형 |
설명 |
|---|---|---|
@FSHO10@SS_UDT_CATALOGNAME |
DBTYPE_WSTR |
UDT 열의 경우 UDT가 정의된 카탈로그의 이름입니다. |
@FSHO10@SS_UDT_SCHEMANAME |
DBTYPE_WSTR |
UDT 열의 경우 UDT가 정의된 스키마의 이름입니다. |
@FSHO10@SS_UDT_NAME |
DBTYPE_WSTR |
UDT 열의 경우 UDT의 단일 부분 이름입니다. |
SS_ASSEMBLY_TYPENAME |
DBTYPE_WSTR |
UDT 열의 경우 UDT의 전체 유형 이름입니다. 어셈블리 유형의 정규화된 이름을 사용하면 Type.GetType 메서드를 사용하여 해당 유형의 개체를 인스턴스화할 수 있습니다. |
PROCEDURE_PARAMETERS 행 집합과 관련해서 DATA_TYPE에는 COLUMNS 스키마 행 집합과 동일한 값이 포함되고 TYPE_NAME에는 UDT가 포함됩니다. 동일한 추가 열도 정의됩니다.
PROVIDER_TYPES 스키마 행 집합에는 사용자 정의 형식이 나타나지 않습니다.
바인딩 및 변환
바인딩 데이터 형식 |
UDT에서 서버로 |
비 UDT에서 서버로 |
서버에서 UDT로 |
서버에서 비 UDT로 |
|---|---|---|---|---|
DBTYPE_UDT |
@FSHO10@지원됨 (5) |
오류 (1) |
@FSHO10@지원됨 (5) |
오류 (4) |
DBTYPE_BYTES |
@FSHO10@지원됨 (5) |
해당 사항 없음 |
@FSHO10@지원됨 (5) |
해당 사항 없음 |
DBTYPE_WSTR |
@FSHO10@지원됨 (2), (5) |
해당 사항 없음 |
지원됨 (3), (5), (6) |
해당 사항 없음 |
DBTYPE_BSTR |
@FSHO10@지원됨 (2), (5) |
해당 사항 없음 |
지원됨 (3), (5) |
해당 사항 없음 |
DBTYPE_STR |
@FSHO10@지원됨 (2), (5) |
해당 사항 없음 |
지원됨 (3), (5) |
해당 사항 없음 |
DBTYPE_IUNKNOWN |
지원됨 (6) |
해당 사항 없음 |
지원됨 (6) |
해당 사항 없음 |
@FSHO10@DBTYPE_VARIANT (VT_UI1 | VT_ARRAY) |
지원됨 (5) |
해당 사항 없음 |
지원됨 (3), (5) |
해당 사항 없음 |
@FSHO10@DBTYPE_VARIANT (VT_BSTR) |
@FSHO10@지원됨 (2), (5) |
해당 사항 없음 |
해당 사항 없음 |
해당 사항 없음 |
@FSHO10@기호 설명
기호 |
의미 |
|---|---|
1 |
DBTYPE_UDT와는 다른 서버 유형이 ICommandWithParameters::SetParameterInfo를 사용하여 지정되고 접근자 유형이 DBTYPE_UDT인 경우 문을 실행하면 오류가 발생합니다. 오류는 DB_E_ERRORSOCCURRED이고 매개 변수 상태는 DBSTATUS_E_BADACCESSOR가 됩니다. UDT가 아닌 서버 매개 변수에 대해 UDT 유형의 매개 변수를 지정하는 것은 오류입니다. |
2 |
데이터가 16진수 문자열에서 이진 데이터로 변환됩니다. |
3 |
데이터가 이진 데이터에서 16진수 문자열로 변환됩니다. |
4 |
CreateAccessor 또는 GetNextRows를 사용할 때 유효성 검사가 수행될 수 있습니다. 오류는 DB_E_ERRORSOCCURRED이고 바인딩 상태는 DBBINDSTATUS_UNSUPPORTEDCONVERSION으로 설정됩니다. |
5 |
BY_REF가 사용될 수 있습니다. |
6 |
UDT 매개 변수를 DBBINDING의 DBTYPE_IUNKNOWN으로 바인딩할 수 있습니다. DBTYPE_IUNKNOWN으로 바인딩할 경우 응용 프로그램이 ISequentialStream 인터페이스를 사용하여 데이터를 스트림으로 처리하려는 것을 나타냅니다. 소비자가 바인딩의 wType을 DBTYPE_IUNKNOWN 유형으로 지정하고 저장 프로시저의 해당 열 또는 출력 매개 변수가 UDT이면 SQL Server Native Client에서 ISequentialStream을 반환합니다. 입력 매개 변수의 경우 SQL Server Native Client에서 ISequentialStream 인터페이스를 쿼리합니다. 큰 UDT의 경우 DBTYPE_IUNKNOWN 바인딩을 사용하는 동안 UDT 데이터의 길이를 바인딩하지 않도록 선택할 수 있습니다. 하지만 작은 UDT의 경우에는 길이를 바인딩해야 합니다. 다음 중 하나 이상이 True이면 DBTYPE_UDT 매개 변수를 큰 UDT로 지정할 수 있습니다.
행 데이터의 경우 DBTYPE_IUNKNOWN 바인딩만 큰 UDT에 사용할 수 있습니다. Rowset의 IColumnsInfo::GetColumnInfo 메서드나 Command 개체의 IColumnsInfo 인터페이스를 사용하여 열이 큰 UDT 유형인지 여부를 확인할 수 있습니다. 다음 중 하나 이상이 True이면 DBTYPE_UDT 열은 큰 UDT 열입니다.
|
DBTYPE_NULL 및 DBTYPE_EMPTY는 입력 매개 변수에 대해서는 바인딩할 수 있지만 출력 매개 변수나 결과에 대해서는 바인딩할 수 없습니다. 입력 매개 변수에 대해 바인딩할 경우 DBTYPE_NULL을 나타내는 DBSTATUS_S_ISNULL 또는 DBTYPE_EMPTY를 나타내는 DBSTATUS_S_DEFAULT로 상태를 설정해야 합니다. DBTYPE_BYREF는 DBTYPE_NULL 또는 DBTYPE_EMPTY에 사용할 수 없습니다.
DBTYPE_UDT를 DBTYPE_EMPTY 및 DBTYPE_NULL로 변환할 수도 있습니다. 하지만 DBTYPE_NULL 및 DBTYPE_EMPTY를 DBTYPE_UDT로 변환할 수는 없습니다. 이는 DBTYPE_BYTES와 일치합니다. ISSCommandWithParameters는 UDT를 매개 변수로 처리하는 데 사용됩니다.
OLE DB 핵심 서비스(IDataConvert)에서 제공하는 데이터 변환은 DBTYPE_UDT에는 적용되지 않습니다.
다른 바인딩은 지원되지 않습니다.
@FSHO10@IRowsetFind 비교
UDT 유형의 경우 다음과 같은 비교만 지원됩니다.
EQ
NE
IGNORE
다른 비교를 시도하면 DB_E_BADCOMPAREOP가 반환됩니다.
UDT에 대한 BCP 지원
UDT 값은 문자나 이진 값으로만 가져오고 내보낼 수 있습니다.
UDT에 대한 하위 수준 클라이언트 동작
UDT에 적용되는 하위 수준 클라이언트와의 유형 매핑은 다음과 같습니다.
클라이언트 버전 |
DBTYPE_UDT @FSHO10@(8,000바이트 이하 길이) |
DBTYPE_UDT @FSHO10@(8,000바이트를 초과하는 길이) |
|---|---|---|
SQL Server 2000 이전 |
varbinary |
image |
SQL Server 2005 |
UDT |
varbinary(max) |
SQL Server 2008 |
UDT |
UDT |
DataTypeCompatibility(SSPROP_INIT_DATATYPECOMPATIBILITY)를 "80"으로 설정하면 큰 UDT 유형이 하위 수준 클라이언트에 대해 표시되는 것과 동일한 방식으로 클라이언트에 표시됩니다.