捲動和擷取數據列 - 將 ODBC 中的數據列加入書籤

適用於:SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System (PDW)

書籤是用來識別資料列的值。 書籤值的意義僅適用於驅動程式或資料來源。 例如,書籤可能跟資料列號碼一樣簡單,也可能跟磁碟位址一樣複雜。 在 ODBC 中,應用程式會要求特定資料列的書籤、將其儲存起來,然後將其傳回資料指標,即可傳回到資料列。

利用 SQLFetchScroll 擷取資料列時,應用程式可以使用書籤當做選取起始資料列的基礎。 這是一個絕對位址的形式,因為它不相依於目前的資料指標位置。 若要捲動到已加入書籤的資料列,應用程式須使用 SQL_FETCH_BOOKMARK 的 FetchOrientation 呼叫 SQLFetchScroll。 此作業會使用SQL_ATTR_FETCH_BOOKMARK_PTR選項屬性所指向的書籤。 它會傳回資料列集,從該書籤識別的資料列開始。 應用程式可以在 SQLFetchScroll 呼叫的 FetchOffset 引數中,指定此作業的位移。 指定位移時,所傳回之資料列集的第一個資料列,會透過將 FetchOffset 引數中的數字加入到書籤所識別之資料列數目來決定。 SQL Server Native Client ODBC 驅動程式僅支援靜態和索引鍵集數據指標上的書籤。 如果在上設定書籤時要求動態數據指標,則會改為開啟索引鍵集數據指標。

書籤也可以與 SQLBulkOperations 函式搭配使用,以在書籤開始的一組數據列上執行作業。

另請參閱

捲動與提取資料列