共用方式為

了解資料指標類型

  • 發行項

下載 JDBC 驅動程式

關聯式資料庫中的作業會針對完整的資料列集運作。 由 SELECT 陳述式所傳回的資料列集包括所有滿足陳述式 WHERE 子句之條件的資料列。 由陳述式傳回的完整資料列稱為結果集。 應用程式不一定能夠以一個單位有效地運用整個結果集。 這些應用程式需要能夠一次運用一個資料列或小型資料列區塊。 資料指標就是一種結果集的擴充，提供此種機制。

資料指標藉由執行下列項目來擴充結果集：

  • 允許定位於結果集中的特定資料列。
  • 從結果集的目前位置，擷取一個資料列或資料列區塊。
  • 支援結果集目前位置上資料列的資料修改。
  • 支援以不同可見度層級來檢視其他使用者對結果集所呈現的資料庫資料所做的變更。

注意

如需 SQL Server 資料指標類型的完整描述，請參閱資料指標的類型。

JDBC 規格支援順向資料指標與可捲動的資料指標，這些資料指標可區分或無法區分其他工作所做的變更，而且可以是唯讀的或可更新的。 這項功能是由 Microsoft JDBC Driver for SQL Server SQLServerResultSet 類別所提供。

備註

JDBC 驅動程式支援下列結果集和資料指標類型，以及指定的行為選項。

結果集 (資料指標) 類型 SQL Server 資料指標類型 特性 select 方法 回應緩衝
TYPE_FORWARD_ONLY (CONCUR_READ_ONLY) N/A 順向、唯讀 直接 完整

應用程式必須單一 (順向) 通過結果集。 此傳遞是預設行為，而且與 TYPE_SS_DIRECT_FORWARD_ONLY 資料指標的行為相同。 驅動程式會在陳述式執行時間，將完整的結果集從伺服器讀入記憶體中。

結果集 (資料指標) 類型 SQL Server 資料指標類型 特性 select 方法 回應緩衝
TYPE_FORWARD_ONLY (CONCUR_READ_ONLY) N/A 順向、唯讀 直接 adaptive

應用程式必須單一 (順向) 通過結果集。 它與 TYPE_SS_DIRECT_FORWARD_ONLY 資料指標的行為相同。 驅動程式會依照應用程式的要求從伺服器讀取資料列，並將用戶端記憶體使用量降到最低。

結果集 (資料指標) 類型 SQL Server 資料指標類型 特性 select 方法 回應緩衝
TYPE_FORWARD_ONLY (CONCUR_READ_ONLY) 向前快轉 順向、唯讀 cursor N/A

應用程式必須使用伺服器資料指標單一 (順向) 通過結果集。 它與 TYPE_SS_SERVER_CURSOR_FORWARD_ONLY 資料指標的行為相同。

從伺服器中擷取資料列 (以提取大小所指定的區塊為單位)。

結果集 (資料指標) 類型 SQL Server 資料指標類型 特性 select 方法 回應緩衝
TYPE_FORWARD_ONLY (CONCUR_UPDATABLE) 動態 (順向) 順向、可更新的 N/A N/A

應用程式必須單一 (順向) 通過結果集以更新一或多個資料列。

從伺服器中擷取資料列 (以提取大小所指定的區塊為單位)。

根據預設，當應用程式呼叫 SQLServerResultSet 物件的 setFetchSize 方法時，提取大小是固定的。

注意

JDBC 驅動程式提供自適性緩衝功能，可讓您在應用程式需要時，從 SQL Server 中擷取陳述式執行結果，而非一次擷取所有結果。 例如，如果應用程式應該擷取的大型資料過大而無法完整納入應用程式記憶體中，適應性緩衝就會允許用戶端應用程式將這類值擷取成資料流。 此驅動程式的預設行為是 "adaptive"。 不過，若要取得順向可更新結果集的適應性緩衝，應用程式必須提供字串值 "adaptive" 來明確呼叫 SQLServerStatement 物件的 setResponseBuffering 方法。 如需範例程式碼，請參閱更新大型資料範例。

結果集 (資料指標) 類型 SQL Server 資料指標類型 特性 select 方法 回應緩衝
TYPE_SCROLL_INSENSITIVE Static 可捲動、不可更新

系統不會顯示外部資料列更新、插入和刪除。		 N/A N/A

應用程式需要資料庫快照集。 此結果集不可更新。 僅支援 CONCUR_READ_ONLY。 搭配這種資料指標類型使用時，所有其他並行類型都會導致例外狀況發生。

從伺服器中擷取資料列 (以提取大小所指定的區塊為單位)。

結果集 (資料指標) 類型 SQL Server 資料指標類型 特性 select 方法 回應緩衝
TYPE_SCROLL_SENSITIVE (CONCUR_READ_ONLY) 索引鍵集 可捲動、唯讀。 系統會顯示外部資料列更新，而且刪除會顯示為遺失資料。

系統不會顯示外部資料列插入。		 N/A N/A

應用程式必須僅針對現有的資料列查看變更的資料。

從伺服器中擷取資料列 (以提取大小所指定的區塊為單位)。

結果集 (資料指標) 類型 SQL Server 資料指標類型 特性 select 方法 回應緩衝
TYPE_SCROLL_SENSITIVE (CONCUR_UPDATABLE、CONCUR_SS_SCROLL_LOCKS、CONCUR_SS_OPTIMISTIC_CC、CONCUR_SS_OPTIMISTIC_CCVAL) 索引鍵集 可捲動、可更新。

系統會顯示外部和內部資料列更新，而且刪除會顯示為遺失資料；但不會顯示插入。		 N/A N/A

應用程式可能會使用 ResultSet 物件來變更現有資料列中的資料。 應用程式也必須能夠查看其他人在 ResultSet 物件外部對資料列所做的變更。

從伺服器中擷取資料列 (以提取大小所指定的區塊為單位)。

結果集 (資料指標) 類型 SQL Server 資料指標類型 特性 select 方法 回應緩衝
TYPE_SS_DIRECT_FORWARD_ONLY N/A 順向、唯讀 N/A 完整或適應性

整數值 = 2003。 提供完整緩衝的唯讀用戶端資料指標。 系統不會建立任何伺服器資料指標。

僅支援 CONCUR_READ_ONLY 並行類型。 搭配這種資料指標類型使用時，所有其他並行類型都會導致例外狀況發生。

結果集 (資料指標) 類型 SQL Server 資料指標類型 特性 select 方法 回應緩衝
TYPE_SS_SERVER_CURSOR_FORWARD_ONLY 向前快轉 順向 N/A N/A

整數值 = 2004。 使用伺服器資料指標來快速存取所有資料。 搭配 CONCUR_UPDATABLE 並行類型使用時，它是可更新的。

從伺服器中擷取資料列 (以提取大小所指定的區塊為單位)。

若要取得此案例的適應性緩衝，應用程式必須提供字串值 "adaptive" 來明確呼叫 SQLServerStatement 物件的 setResponseBuffering 方法。 如需範例程式碼，請參閱更新大型資料範例。

結果集 (資料指標) 類型 SQL Server 資料指標類型 特性 select 方法 回應緩衝
TYPE_SS_SCROLL_STATIC Static 系統不會反映其他使用者的更新。 N/A N/A

整數值 = 1004。 應用程式需要資料庫快照集。 此選項是 JDBC TYPE_SCROLL_INSENSITIVE 的 SQL Server 特定同義字，具有相同的並行設定行為。

從伺服器中擷取資料列 (以提取大小所指定的區塊為單位)。

結果集 (資料指標) 類型 SQL Server 資料指標類型 特性 select 方法 回應緩衝
TYPE_SS_SCROLL_KEYSET (CONCUR_READ_ONLY) 索引鍵集 可捲動、唯讀。 系統會顯示外部資料列更新，而且刪除會顯示為遺失資料。

系統不會顯示外部資料列插入。		 N/A N/A

整數值 = 1005。 應用程式必須僅針對現有的資料列查看變更的資料。 此選項是 JDBC TYPE_SCROLL_SENSITIVE 的 SQL Server 特定同義字，具有相同的並行設定行為。

從伺服器中擷取資料列 (以提取大小所指定的區塊為單位)。

結果集 (資料指標) 類型 SQL Server 資料指標類型 特性 select 方法 回應緩衝
TYPE_SS_SCROLL_KEYSET (CONCUR_UPDATABLE、CONCUR_SS_SCROLL_LOCKS、CONCUR_SS_OPTIMISTIC_CC、CONCUR_SS_OPTIMISTIC_CCVAL) 索引鍵集 可捲動、可更新。

系統會顯示外部和內部資料列更新，而且刪除會顯示為遺失資料；但不會顯示插入。		 N/A N/A

整數值 = 1005。 應用程式必須變更資料或針對現有的資料列查看變更的資料。 此選項是 JDBC TYPE_SCROLL_SENSITIVE 的 SQL Server 特定同義字，具有相同的並行設定行為。

從伺服器中擷取資料列 (以提取大小所指定的區塊為單位)。

結果集 (資料指標) 類型 SQL Server 資料指標類型 特性 select 方法 回應緩衝
TYPE_SS_SCROLL_DYNAMIC (CONCUR_READ_ONLY) 動態 可捲動、唯讀。

系統會顯示外部資料列更新和插入，而且刪除在目前的提取緩衝區中，會顯示為暫時遺失的資料。		 N/A N/A

整數值 = 1006。 應用程式必須針對現有的資料列查看變更的資料，並查看在資料指標存留時間期間插入以及刪除的資料列。

從伺服器中擷取資料列 (以提取大小所指定的區塊為單位)。

結果集 (資料指標) 類型 SQL Server 資料指標類型 特性 select 方法 回應緩衝
TYPE_SS_SCROLL_DYNAMIC (CONCUR_UPDATABLE、CONCUR_SS_SCROLL_LOCKS、CONCUR_SS_OPTIMISTIC_CC、CONCUR_SS_OPTIMISTIC_CCVAL) 動態 可捲動、可更新。

系統會顯示外部和內部資料列更新和插入，而且刪除在目前的提取緩衝區中，會顯示為暫時遺失的資料。		 N/A N/A

整數值 = 1006。 應用程式可能會使用 ResultSet 物件來變更現有資料列的資料，或者插入或刪除資料列。 應用程式也必須能夠查看其他人在 ResultSet 物件外部所做的變更、插入和刪除。

從伺服器中擷取資料列 (以提取大小所指定的區塊為單位)。

資料指標定位

TYPE_FORWARD_ONLY、TYPE_SS_DIRECT_FORWARD_ONLY 和 TYPE_SS_SERVER_CURSOR_FORWARD_ONLY 資料指標僅支援 next 定位方法。

TYPE_SS_SCROLL_DYNAMIC 資料指標不支援 absolute 和 getRow 方法。 結合動態資料指標之 first 和 relative 方法的呼叫近似 absolute 方法。

只有 TYPE_FORWARD_ONLY、TYPE_SS_DIRECT_FORWARD_ONLY、TYPE_SS_SERVER_CURSOR_FORWARD_ONLY、TYPE_SS_SCROLL_KEYSET 和 TYPE_SS_SCROLL_STATIC 資料指標支援 getRow 方法。 具有全部順向資料指標類型的 getRow 方法會傳回目前透過資料指標讀取的資料列數目。

注意

當應用程式進行不支援的資料指標定位呼叫時，或進行不支援的 getRow 方法呼叫時，會擲回一個例外狀況訊息：「不支援使用此資料指標類型來執行要求的作業」。

只有 TYPE_SS_SCROLL_KEYSET 和相等的 TYPE_SCROLL_SENSITIVE 資料指標會公開已刪除的資料列。 如果資料指標定位在已刪除的資料列上，則無法使用資料行值，而且 rowDeleted 方法會傳回 "true"。 呼叫 get<Type> 方法會擲回例外狀況，並顯示訊息「無法從已刪除的資料列取得值」。 無法更新已刪除的資料列。 如果您嘗試在已刪除的資料列上呼叫 update<Type> 方法，則會擲回例外狀況，並顯示訊息「無法更新已刪除的資料列」。 TYPE_SS_SCROLL_DYNAMIC 資料指標在移出目前的提取緩衝區之前的行為都相同。

向前資料指標和動態資料指標會以類似的方式公開已刪除的資料列，但是只有在資料指標仍可在提取緩衝區中存取時才是如此。 若是順向資料指標，此行為會相當簡單。 若是動態資料指標，當擷取大小大於 1 時，則比較複雜。 應用程式可以在提取緩衝區定義的視窗內前後移動資料指標，但是在遺失已更新的原始提取緩衝區時，已刪除的資料列將會消失。 如果應用程式不想使用動態資料指標查看暫時刪除的資料列，則應使用 fetch relative (0)。

如果 TYPE_SS_SCROLL_KEYSET 或 TYPE_SCROLL_SENSITIVE 資料指標資料列的索引鍵值隨著資料指標一起更新，則無論更新的資料列是否符合資料指標的選取條件，資料列都會保留在結果集中的原始位置。 如果資料列是在資料指標外部更新，已刪除的資料列將會出現在資料列的原始位置，但是只有在具有新索引鍵值的另一個資料列在已經刪除後出現在資料指標時，資料列才會出現在資料指標中。

若是動態資料指標，更新的資料列會保留在擷取緩衝區中的位置，直到離開擷取緩衝區所定義的視窗為止。 更新的資料列稍後可能會重複出現在資料集中的不同位置，也可能完全消失。 必須防止在結果集中產生暫時不一致的應用程式應該使用的提取大小為 1 (預設 CONCUR_SS_SCROLL_LOCKS 並行有 8 個資料列，而其他並行有 128 個資料列)。

資料指標轉換

SQL Server 有時候可以選擇實作要求以外的資料指標類型，也就是所謂的隱含性資料指標轉換 (或資料指標轉化)。

在 SQL Server 2000 (8.x) 中，當您透過 ResultSet.TYPE_SCROLL_SENSITIVE 和 ResultSet.CONCUR_UPDATABLE 結果集更新資料時，會擲回例外狀況，並顯示訊息「資料指標為 READ ONLY」。 因為 SQL Server 2000 (8.x) 已針對該結果集進行隱含性資料指標轉換，而且未傳回所要求的可更新資料指標，所以會發生此例外狀況。

若要解決這個問題，您可以執行下列其中一種解決方案：

資料指標更新

對於資料指標類型和並行支援更新的資料指標，支援就地更新。 如果資料指標不在結果集中的可更新資料列上 (get<Type> 方法呼叫不會成功)，呼叫 update<Type> 方法會擲回例外狀況，並顯示訊息「結果集目前沒有資料列」。JDBC 規格指出，針對資料指標為 CONCUR_READ_ONLY 的資料行呼叫更新方法時，會引發例外狀況。 在資料列無法更新的情況下；例如，因為競相更新或刪除之類的開放式並行衝突，在呼叫 insertRow、updateRow 或 deleteRow 前，可能不會引發例外狀況。

呼叫 update<Type> 之後，在呼叫 updateRow 或 cancelRowUpdates 之前，get<Type> 將無法存取受影響的資料行。 此行為可避免下列問題：使用不同於伺服器所傳回之類型更新資料行時，後續 getter 呼叫可能會叫用用戶端類型轉換而提供不正確的結果。 呼叫 get<Type> 會擲回例外狀況，並顯示訊息「直到呼叫 updateRow() 或 cancelRowUpdates() 之後，才能存取已更新的資料行」。

注意

如果在尚未更新任何資料行時呼叫 updateRow 方法，JDBC 驅動程式將會擲回例外狀況訊息：「尚未更新任何資料行時呼叫 updateRow()」。

呼叫 moveToInsertRow 之後，如果在結果集上呼叫非 get<Type>、update<Type>、insertRow 和資料指標定位方法 (包括 moveToCurrentRow) 的任何方法，則會擲回例外狀況。 moveToInsertRow 方法會將結果集有效地放入插入模式中，然後資料指標定位方法會中止插入模式。 相對的資料指標定位呼叫會移動呼叫 moveToInsertRow 前，位置的相對資料指標。 資料指標定位呼叫後，最終的目的地資料指標位置會變成新的資料指標位置。

如果在插入模式不成功時進行資料指標定位呼叫，呼叫失敗之後的資料指標位置會是呼叫 moveToInsetRow 之前的原始資料指標位置。 如果 insertRow 失敗，資料指標仍然會在插入資料列上，而且資料指標仍然會在插入模式下。

插入資料列中的資料行一開始會處於未初始化的狀態。 呼叫 update<Type> 方法會將資料行狀態設定為已初始化。 針對未初始化的資料行呼叫 get<Type> 方法會擲回例外狀況。 insertRow 方法的呼叫會將插入資料列中的所有資料行返回到未初始化的狀態。

如果在呼叫 insertRow 方法時未初始化任何資料行，則會插入資料行的預設值。 如果沒有預設值，但資料行可為 Null，則會插入 NULL。 如果沒有預設值，而且資料行不可為 Null，則伺服器將會傳回錯誤，而且將會擲回例外狀況。

注意

getRow 方法的呼叫在插入模式時會傳回 0。

JDBC 驅動程式不支援定位更新或刪除。 根據 JDBC 規格，setCursorName 方法沒有效果，而 getCursorName 方法將會擲回例外狀況 (如果呼叫的話)。

唯讀和靜態資料指標絕對是不可更新的。

SQL Server 會將伺服器資料指標限制為單一結果集。 如果某個批次或預存程序包含多個陳述式，則必須使用順向唯讀用戶端資料指標。

另請參閱

使用 JDBC 驅動程式管理結果集