sp_cursorexecute (Transact-SQL)
適用於:SQL Server
根據sp_cursorprepare所建立的執行計劃,建立並填入數據指標。 此程式加上sp_cursorprepare,具有與sp_cursoropen相同的函式,但會分割成兩個階段。 在表格式數據流 (TDS) 封包中指定 ID =4 來叫用sp_cursorexecute。
語法
sp_cursorexecute prepared_handle, cursor
[ , scrollopt[ OUTPUT ]
[ , ccopt[ OUTPUT ]
[ ,rowcount OUTPUT [ ,bound param][,...n]]]]]
引數
prepared_handle
這是由 sp_cursorprepare 傳回的備妥語句 句柄 值。 prepared_handle是呼叫 int 輸入值的必要參數。
cursor
這是 SQL Server 產生的數據指標標識碼。 cursor 是必要參數,必須在對數據指標採取動作的所有後續程式上提供,例如sp_cursorfetch
scrollopt
捲動選項。 scrollopt 是選擇性參數,需要 int 輸入值。 sp_cursorexecute scrollopt 參數的值選項與sp_cursoropen的值選項相同。
注意
不支援PARAMETERIZED_STMT值。
重要
如果未指定 scrollopt 值,則不論sp_cursorprepare中指定的 scrollopt 值為何,預設值都是 KEYSET。
ccopt
貨幣控制選項。 ccopt 是選擇性參數,需要 int 輸入值。 sp_cursorexecute ccopt 參數的值選項與sp_cursoropen的值選項相同。
重要
如果未指定 ccopt 值,則不論sp_cursorprepare中指定的 ccopt 值為何,預設值都是 OPTIMISTIC。
rowcount
這是選擇性參數,表示要搭配AUTO_FETCH使用的擷取緩衝區數據列數目。 預設值為20個數據列。 當指派為輸入值與傳回值時,rowcount 的行為會有所不同。
作為輸入值 | 作為傳回值 |
---|---|
使用 FAST_FORWARD數據指標 數據列計數 指定AUTO_FETCH時,代表要放入提取緩衝區的數據列數目。 | 表示結果集中的數據列數目。 指定 scrollopt AUTO_FETCH 值時,rowcount 會傳回擷取至提取緩衝區的數據列數目。 |
bound_param
表示選擇性地使用其他參數。
注意
第五個之後的任何參數會以輸入參數的形式傳遞至語句計劃。
程式代碼傳回值
rowcount 可能會傳回下列值。
值 | Description |
---|---|
-1 | 未知的數據列數目。 |
-n | 異步母體擴展實際上已生效。 |
備註
scrollopt 和 ccopt 參數
當快取計劃先佔伺服器快取時,scrollopt 和 ccopt 會很有用,這表示識別語句的備妥句柄必須重新編譯。 scrollopt 和 ccopt 參數值必須符合原始要求中所傳送的值,才能sp_cursorprepare。
注意
PARAMETERIZED_STMT不應該指派給 scrollopt。
無法提供比對值會導致重新編譯計劃,而否定準備和執行作業。
RPC 和 TDS 考慮
RPC RETURN_METADATA輸入旗標可以設定為 1,要求在 TDS 數據流中傳回數據指標選取清單元數據。
另請參閱
sp_cursoropen (Transact-SQL)
sp_cursorfetch (Transact-SQL)
系統預存程序 (Transact-SQL)
意見反映
https://aka.ms/ContentUserFeedback。
即將推出:我們會在 2024 年淘汰 GitHub 問題,並以全新的意見反應系統取代並作為內容意見反應的渠道。 如需更多資訊,請參閱:提交及檢視以下的意見反映: