다음을 통해 공유

SQL Server Native Client의 OLE DB 테이블 반환 매개 변수 형식 지원(속성)

  • 아티클

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System(PDW)

이 항목에서는 테이블 반환 매개 변수 행 집합 개체와 연관된 OLE DB 속성 및 속성 집합에 대한 정보를 제공합니다.

속성

다음은 테이블 반환 매개 변수 행 집합 개체의 IRowsetInfo::GetProperties 메서드를 통해 노출되는 속성 목록입니다. 테이블 반환 매개 변수 행 집합 속성은 모두 읽기 전용입니다. 따라서 IOpenRowset::OpenRowset 또는 ITableDefinitionWithConstraints::CreateTableWithConstraints 메서드를 통해 속성을 기본값이 아닌 값으로 설정하려고 하면 오류가 발생하며 개체가 만들어지지 않습니다.

테이블 반환 매개 변수 행 집합 개체에 구현되지 않은 속성은 다음 목록에 없습니다. 전체 속성 목록을 보려면 Windows Data Access Components의 OLE DB 설명서를 참조하십시오.

속성 ID 값
DBPROP_ABORTPRESERVE VARIANT_TRUE
DBPROP_ACCESSORDER DBPROPVAL_AO_RANDOM
DBPROP_BLOCKINGSTORAGEOBJECTS VARIANT_TRUE
DBPROP_BOOKMARKS

DBPROP_LITERALBOOKMARKS		 R/W: 읽기 전용

Default: VARIANT_FALSE

설명: 테이블 반환 매개 변수 행 집합 개체에는 책갈피가 허용되지 않습니다.
DBPROP_BOOKMARKSKIPPED VARIANT_FALSE
DBPROP_BOOKMARKTYPE DBPROPVAL_BMK_NUMERIC
DBPROP_CANHOLDROWS VARIANT_FALSE
DBPROP_CHANGEINSERTEDROWS VARIANT_TRUE
DBPROP_COLUMNRESTRICT VARIANT_FALSE
DBPROP_COMMANDTIMEOUT 0
DBPROP_COMMITPRESERVE VARIANT_TRUE
DBPROP_DEFERRED VARIANT_FALSE
DBPROP_DELAYSTORAGEOBJECTS VARIANT_FALSE
DBPROP_IAccessor

DBPROP_IColumnsInfo

DBPROP_IConvertType

DBPROP_IRowset

DBPROP_IRowsetInfo

DBPROP_IColumnsRowset		 VARIANT_TRUE
DBPROP_IConnectionPointContainer

DBPROP_IMultipleResults

DBPROP_IRowsetUpdate

DBPROP_IRowsetIdentity

DBPROP_IRowsetLocate

DBPROP_IRowsetScroll

DBPROP_IRowsetResynch		 VARIANT_FALSE
DBPROP_IRowsetChange VARIANT_TRUE

참고: 테이블 반환 매개 변수 행 집합 개체는 IRowsetChange 인터페이스를 지원합니다.

VARIANT_TRUE 동일한 DBPROP_IRowsetChange 사용하여 만든 행 집합은 즉각적인 업데이트 모드 동작을 나타냅니다.

그러나 BLOB 열이 ISequentialStream 개체로 바인딩되는 경우 소비자는 테이블 반환 매개 변수 행 집합 개체의 수명 동안 보관해야 합니다.
DBPROP_ISupportErrorInfo VARIANT_TRUE
DBPROP_ISequentialStream VARIANT_TRUE
DBPROP_IMMOBILEROWS VARIANT_TRUE
DBPROP_LITERALIDENTITY VARIANT_TRUE
DBPROP_LOCKMODE DBPROPVAL_LM_NONE
DBPROP_MAXOPENROWS 0
DBPROP_MAXPENDINGROWS 0
DBPROP_MAXROWS 0
DBPROP_NOTIFICATIONPHASES 0
DBPROP_NOTIFYCOLUMNSET DBPROP_NOTIFYROWDELETE DBPROP_NOTIFYROWFIRSTCHANGE DBPROP_NOTIFYROWINSERT DBPROP_NOTIFYROWRESYNCH DBPROP_NOTIFYROWSETRELEASE DBPROP_NOTIFYROWSETFETCH-POSITIONCHANGE DBPROP_NOTIFYROWUNDOCHANGE DBPROP_NOTIFYROWUNDODELETE DBPROP_NOTIFYROWUNDOINSERT DBPROP_NOTIFYROWUPDATE 0
DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE VARIANT_FALSE
DBPROP_OWNINSERT

DBPROP_OWNUPDATEDELETE		 VARIANT_TRUE
DBPROP_QUICKRESTART VARIANT_TRUE
DBPROP_REENTRANTEVENTS VARIANT_FALSE
DBPROP_REMOVEDELETED VARIANT_TRUE
DBPROP_RETURNPENDINGINSERTS VARIANT_TRUE
DBPROP_ROWRESTRICT VARIANT_FALSE
DBPROP_ROWTHREADMODEL DBPROPVAL_RT_FREETHREAD
DBPROP_SERVERCURSOR VARIANT_FALSE
DBPROP_SERVERDATAONINSERT VARIANT_FALSE
DBPROP_STRONGIDENTITY VARIANT_TRUE
DBPROP_TRANSACTEDOBJECT VARIANT_FALSE
DBPROP_UNIQUEROWS VARIANT_FALSE
DBPROP_UPDATABILITY DBPROPVAL_UP_CHANGE | DBPROPVAL_UP_DELETE | DBPROPVAL_UP_INSERT

속성 집합

다음 속성 집합은 테이블 반환 매개 변수를 지원합니다.

DBPROPSET_SQLSERVERCOLUMN

이 속성은 필요한 경우 DBCOLUMNDESC 구조를 통해 각 열에 대해 ITableDefinitionWithConstraints::CreateTableWithConstraints를 사용하여 테이블 반환 매개 변수 행 집합 개체를 만드는 과정에서 소비자가 사용합니다.

속성 ID 속성 값
SSPROP_COL_COMPUTED R/W: 읽기/쓰기

Default: VARIANT_FALSE

유형: VT_BOOL

설명: VARIANT_TRUE 설정하면 열이 계산 열임을 나타냅니다. VARIANT_FALSE 계산 열이 아님을 나타냅니다.

DBPROPSET_SQLSERVERPARAMETER

이러한 속성은 소비자가 ISSCommandWithParameters::GetParameterProperties에 대한 호출에서 테이블 반환 매개 변수 형식 정보를 검색하는 동안 읽혀지고, 소비자가 ISSCommandWithParameters::SetParameterProperties를 통해 테이블 반환 매개 변수에 대한 특정 속성을 설정하는 동안 설정됩니다.

다음 표에서는 이러한 속성에 대한 자세한 설명을 제공합니다.

속성 ID 속성 값
SSPROP_PARAM_TYPE_TYPENAME R/W: 읽기/쓰기

Default: VT_EMPTY

유형: VT_BSTR

설명: 소비자는 이 속성을 사용하여 테이블 반환 매개 변수 형식의 이름을 얻거나 설정합니다.

이 속성은 CLR 사용자 정의 형식과 함께 사용할 수도 있습니다.

이 속성은 필요에 따라 테이블 반환 매개 변수에 대한 테이블 형식 이름을 제공하도록 지정할 수 있습니다(ODBC 호출 구문 명령의 경우). 이 속성은 임시 매개 변수가 있는 SQL 쿼리에 필요합니다.
SSPROP_PARAM_TYPE_SCHEMANAME R/W: 읽기/쓰기

Default: VT_EMPTY

유형: VT_BSTR

설명: 소비자는 이 속성을 사용하여 테이블 반환 매개 변수 형식의 스키마 이름을 얻거나 설정합니다.

이 속성은 CLR 사용자 정의 형식과 함께 사용할 수도 있습니다.
SSPROP_PARAM_TYPE_CATALOGNAME R/W: 읽기 전용

Default: VT_EMPTY

유형: VT_BSTR

설명: 소비자는 이 속성을 사용하여 테이블 반환 매개 변수 형식의 카탈로그 이름을 가져옵니다.

이 속성은 CLR 사용자 정의 형식과 함께 사용할 수도 있습니다. 이 속성을 설정하는 것은 오류입니다. 사용자 정의 테이블 형식은 해당 형식을 사용하는 테이블 반환 매개 변수와 동일한 데이터베이스에 있어야 합니다.
SSPROP_PARAM_TABLE_DEFAULT_COLUMNS R/W: 읽기/쓰기

Default: VT_EMPTY

형식: VT_UI2 | VT_ARRAY

설명: 소비자는 이 속성을 사용하여 행 집합에서 기본값으로 처리할 열 집합을 지정합니다. 해당 열에 대한 값은 전송되지 않습니다. 공급자가 소비자 행 집합 개체에서 데이터를 인출하는 동안 이러한 열에 대해서는 바인딩이 필요하지 않습니다.

배열의 각 요소는 행 집합 개체에서 열의 순서를 나타내는 서수여야 합니다. 잘못된 서수를 지정하면 명령 실행 시 오류가 발생합니다.
SSPROP_PARAM_TABLE_COLUMN_ORDER R/W: 읽기/쓰기

Default: VT_EMPTY

형식: VT_UI2 | VT_ARRAY

설명: 이 속성은 소비자가 열 데이터의 정렬 순서를 나타내는 힌트를 서버에 제공하는 데 사용합니다. 공급자는 유효성 검사를 수행하지 않으며 소비자가 제공된 사양을 준수한다고 가정합니다. 서버는 이 속성을 사용하여 최적화를 수행합니다.

각 열의 열 순서 정보는 배열의 요소 쌍으로 표시됩니다. 쌍의 첫 번째 요소는 열의 수입니다. 쌍의 두 번째 요소는 오름차순의 경우 1, 내림차순의 경우 2입니다.

참고 항목

OLE DB 테이블 반환 매개 변수 형식 지원
테이블 반환 매개 변수 사용(OLE DB)