OLE DB로 Seek 메서드 사용
Seek 메서드는 Microsoft SQL Server Compact 4.0의 인덱스에서 클라이언트가 가장 많이 사용하는 메서드입니다. Seek를 사용하면 커서에서 매우 빠르게 행을 찾을 수 있습니다.
Seek 사용
Seek 메서드가 제대로 작동하려면 검색 키 열에 인덱스가 정의되어 있어야 합니다. 대부분의 검색 작업은 특정 값을 찾는 데 사용되지만 "보다 큼" 또는 "보다 작음" 등의 여러 비교 연산자를 사용한 검색도 가능합니다.
IRowsetIndex::Seek는 데이터를 가져오고 설정하는 데 사용되는 OLE DB의 접근자 메커니즘을 통해 공급자에게 값을 전달합니다. Seek메서드에 대해 사용되는 접근자에는 IRowset::GetData 및 IRowset::SetData 접근자에 적용되는 것보다 더 많은 제한이 적용됩니다. 접근자는 인덱스 키에 나타난 순서로 열을 바인딩해야 합니다.
IRowsetPosition 인터페이스는 스크롤형 커서에서만 지원됩니다.
예
다음 예에서는 SQL Server Compact 4.0용 OLE DB 공급자를 사용하는 인덱스에서 IRowsetIndex::Seek를 사용하는 방법을 보여 줍니다. 이 예에는 Seek 메서드와 관련된 함수의 섹션만 포함되어 있습니다.
다음 예는 32비트 플랫폼과 64비트 플랫폼 모두에 대해 업데이트되었습니다. 64비트의 호환 가능한 유형은 sqlce_oledb.h 네이티브 헤더 파일에서 가져온 것입니다. %ProgramFiles%\Microsoft SQL Server Compact Edition\v3.5\Include 폴더에서 sqlce_oledb.h 네이티브 헤더 파일을 찾을 수 있습니다. 자세한 내용은 Microsoft 웹 사이트에서 OLE DB Programmer's Guide의 OLE DB 64비트 정보 항목을 참조하십시오.
TableID.eKind = DBKIND_NAME;
TableID.uName.pwszName = (WCHAR*)TABLE_EMPLOYEE;
IndexID.eKind = DBKIND_NAME;
IndexID.uName.pwszName = L"PK_Employees";
// Request ability to use IRowsetChange interface.
rowsetpropset[0].cProperties = 1;
rowsetpropset[0].guidPropertySet = DBPROPSET_ROWSET;
rowsetpropset[0].rgProperties = rowsetprop;
rowsetprop[0].dwPropertyID = DBPROP_IRowsetIndex;
rowsetprop[0].dwOptions = DBPROPOPTIONS_REQUIRED;
rowsetprop[0].colid = DB_NULLID;
rowsetprop[0].vValue.vt = VT_BOOL;
rowsetprop[0].vValue.boolVal = VARIANT_TRUE;
// Open the table using the index.
hr = pIOpenRowset->OpenRowset(NULL, &TableID, &IndexID,
IID_IRowsetIndex, sizeof(rowsetpropset)/sizeof(rowsetpropset[0]),
rowsetpropset, (IUnknown**) &pIRowsetIndex);
if(FAILED(hr))
{
goto Exit;
}
// Get the IRowset interface.
hr = pIRowsetIndex->QueryInterface(IID_IRowset, (void**) &pIRowset);
if(FAILED(hr))
{
goto Exit;
}
///////////////////////////////////////////////////////////////////////
// Steps to get column data using IcolumnsInfo have been removed
///////////////////////////////////////////////////////////////////////
// Create a DBBINDING array.
dwBindingSize = sizeof(pwszEmployees)/sizeof(pwszEmployees[0]);
prgBinding = (DBBINDING*)CoTaskMemAlloc(sizeof(DBBINDING)*dwBindingSize);
if (NULL == prgBinding)
{
hr = E_OUTOFMEMORY;
goto Exit;
}
// Set initial offset for binding position.
dwOffset = 0;
// Prepare structures to create an accessor for each index.
for (dwIndex = 0; dwIndex < dwBindingSize; ++dwIndex)
{
if (!GetColumnOrdinal(pDBColumnInfo, ulNumCols, pwszEmployees[dwIndex], &dwOrdinal))
{
hr = E_FAIL;
goto Exit;
}
prgBinding[dwIndex].iOrdinal = dwOrdinal;
prgBinding[dwIndex].dwPart = DBPART_VALUE | DBPART_STATUS | DBPART_LENGTH;
prgBinding[dwIndex].obLength = dwOffset;
prgBinding[dwIndex].obStatus = prgBinding[dwIndex].obLength + sizeof(DBLENGTH);
prgBinding[dwIndex].obValue = prgBinding[dwIndex].obStatus + sizeof(DBSTATUS);
prgBinding[dwIndex].pTypeInfo = NULL;
prgBinding[dwIndex].pBindExt = NULL;
prgBinding[dwIndex].dwMemOwner = DBMEMOWNER_CLIENTOWNED;
prgBinding[dwIndex].dwFlags = 0;
prgBinding[dwIndex].bPrecision = pDBColumnInfo[dwOrdinal].bPrecision;
prgBinding[dwIndex].bScale = pDBColumnInfo[dwOrdinal].bScale;
///////////////////////////////////////////////////////////////////////
// Case-specific binding information has been removed.
///////////////////////////////////////////////////////////////////////
prgBinding[dwIndex].pObject NULL;
prgBinding[dwIndex].wType = pDBColumnInfo[dwOrdinal].wType;
if(DBTYPE_WSTR == pDBColumnInfo[dwOrdinal].wType)
{
prgBinding[dwIndex].cbMaxLen = pDBColumnInfo[dwOrdinal].ulColumnSize
* sizeof(WCHAR);
}
else
{
prgBinding[dwIndex].cbMaxLen = pDBColumnInfo[dwOrdinal].ulColumnSize;
}
// Calculate and align the offset.
}
// Get IAccessor interface.
hr = pIRowset->QueryInterface(IID_IAccessor, (void**)&pIAccessor);
if(FAILED(hr))
{
goto Exit;
}
// Create the accessor.
hr = pIAccessor->CreateAccessor(DBACCESSOR_ROWDATA, dwBindingSize,
prgBinding, 0, &hAccessor, NULL);
if(FAILED(hr))
{
goto Exit;
}
// Allocate data buffer for seek and retrieve operation.
pData = (BYTE*)CoTaskMemAlloc(dwOffset);
if (NULL == pData)
{
hr = E_OUTOFMEMORY;
goto Exit;
}
// Set data buffer to zero.
//
memset(pData, 0, dwOffset);
// Set data buffer for seek operation by specifying the
// dwEmployeeID variable that is passed to the function.
*(DBLENGTH*)(pData+prgBinding[0].obLength) = 4;
*(DBSTATUS*)(pData+prgBinding[0].obStatus) = DBSTATUS_S_OK;
*(int*)(pData+prgBinding[0].obValue) = dwEmployeeID;
// Seek for the first row where the value of the selected column
// is dwEmployeeID.
hr = pIRowsetIndex->Seek(hAccessor, 1, pData, DBSEEK_FIRSTEQ);
if(FAILED(hr))
{
goto Exit;
}
// Retrieve a row handle for the row resulting from the seek.
hr = pIRowset->GetNextRows(DB_NULL_HCHAPTER, 0, 1, &cRowsObtained,
&prghRows);
if(FAILED(hr))
{
goto Exit;
}
///////////////////////////////////////////////////////////////////////
// Perform programming logic here on the
// returned rowset, and then release the rowset.
///////////////////////////////////////////////////////////////////////
Exit:
///////////////////////////////////////////////////////////////////////
// This is where the resources are released.
///////////////////////////////////////////////////////////////////////
return hr;