- 相關(guān)軟件
>sp_cursor_list 創(chuàng)建者：webmaster 更新時間：2006-02-16 15:51報告當(dāng)前為連接打開的服務(wù)器游標(biāo)的特性。
語法
sp_cursor_list [ @cursor_return = ] cursor_variable_name OUTPUT
, [ @cursor_scope = ] cursor_scope參數(shù)
[@cursor_return =] cursor_variable_name OUTPUT
聲明的游標(biāo)變量的名稱。cursor_variable_name 的數(shù)據(jù)類型為 cursor，沒有默認(rèn)值。游標(biāo)是可滾動的、動態(tài)的只讀游標(biāo)。
[@cursor_scope =] cursor_scope
指定要報告的游標(biāo)級別。cursor_scope 的數(shù)據(jù)類型為 int，沒有默認(rèn)值，可以是下列值中的一個。
值 描述 1 報告所有本地游標(biāo)。 2 報告所有全局游標(biāo)。 3 報告本地游標(biāo)和全局游標(biāo)。 返回代碼值
無
返回的游標(biāo)
sp_cursor_list 返回的報告是 Transact-SQL 游標(biāo)輸出參數(shù)，而不是結(jié)果集。這樣，Transact-SQL 批處理、存儲過程和觸發(fā)器就得以按一次一行的方式處理輸出。這還意味著無法直接從數(shù)據(jù)庫 API 函數(shù)調(diào)用該過程。游標(biāo)輸出參數(shù)必須綁定到程序變量，但是數(shù)據(jù)庫 API 不支持綁定游標(biāo)參數(shù)或變量。
以下是 sp_cursor_list 返回的游標(biāo)格式。游標(biāo)格式與 sp_describe_cursor 返回的格式相同。
列名 數(shù)據(jù)類型 描述 reference_name sysname 用來引用游標(biāo)的名稱。如果通過 DECLARE CURSOR 語句中給定的名稱引用游標(biāo)，則引用名稱與游標(biāo)名稱相同。如果通過變量引用游標(biāo)，則引用名稱即為游標(biāo)變量的名稱。 cursor_name sysname 來自 DECLARE CURSOR 語句的游標(biāo)名稱。如果游標(biāo)是通過將游標(biāo)變量設(shè)置為游標(biāo)而創(chuàng)建的，則游標(biāo)名稱為系統(tǒng)生成的名稱。 cursor_scope smallint 1 = LOCAL
2 = GLOBALstatus smallint 與 CURSOR_STATUS 系統(tǒng)函數(shù)報告的值相同： 1 = 游標(biāo)名稱或變量引用的游標(biāo)打開。如果游標(biāo)為不感知游標(biāo)、靜態(tài)游標(biāo)或鍵集游標(biāo)，則至少包含一行。如果游標(biāo)是動態(tài)游標(biāo)，則結(jié)果集包含零行或更多的行。
0 = 游標(biāo)名稱或變量引用的游標(biāo)打開但是沒有行。動態(tài)游標(biāo)不會返回此值。
-1 = 游標(biāo)名稱或變量引用的游標(biāo)關(guān)閉。
-2 = 只適用于游標(biāo)變量。沒有給變量指派游標(biāo)。很可能 OUTPUT 參數(shù)給變量指派了游標(biāo)，但存儲過程在返回前關(guān)閉了此游標(biāo)。
-3 = 指定名稱的游標(biāo)或游標(biāo)變量不存在，或尚未給游標(biāo)變量分配游標(biāo)。model smallint 1 = 不感知（或靜態(tài)）
2 = 鍵集
3 = 動態(tài)
4 = 快進(jìn)concurrency smallint 1 = 只讀
2 = 滾動鎖
3 = 樂觀scrollable smallint 0 = 只進(jìn)
1 = 可滾動open_status smallint 0 = 關(guān)閉
1 = 打開cursor_rows int 結(jié)果集中合格的行數(shù)。有關(guān)更多信息，請參見 @@CURSOR_ROWS。 fetch_status smallint 此游標(biāo)上次提取的狀態(tài)。有關(guān)更多信息，請參見 @@FETCH_STATUS。 0 = 提取成功。
-1 = 提取失敗或超過游標(biāo)的界限。
-2 = 請求的行丟失。
-9 = 游標(biāo)上沒有提取。column_count smallint 游標(biāo)結(jié)果集中的列數(shù)。 row_count smallint 上次對游標(biāo)的操作所影響的行數(shù)。有關(guān)更多信息，請參見 @@ROWCOUNT。 last_operation smallint 上次對游標(biāo)執(zhí)行的操作： 0 = 沒有對游標(biāo)執(zhí)行操作。
1 = OPEN
2 = FETCH
3 = INSERT
4 = UPDATE
5 = DELETE
6 = CLOSE
7 = DEALLOCATEcursor_handle int 在服務(wù)器范圍內(nèi)標(biāo)識游標(biāo)的唯一值。 注釋
sp_cursor_list 生成連接打開的當(dāng)前服務(wù)器游標(biāo)列表，并描述每個游標(biāo)的全局特性，例如游標(biāo)的可滾動性和可更新性。sp_cursor_list 列出的游標(biāo)包括：
- Transact-SQL 服務(wù)器游標(biāo)。
- API 服務(wù)器游標(biāo)，由 ODBC 應(yīng)用程序打開，然后調(diào)用 SQLSetCursorName 給游標(biāo)命名。
使用 sp_describe_cursor_columns 描述由游標(biāo)返回的結(jié)果集的特性。使用 sp_describe_cursor_tables 報告游標(biāo)引用的基表。sp_describe_cursor 與 sp_cursor_list 報告的信息相同，但前者只適用于指定的游標(biāo)。
權(quán)限
執(zhí)行權(quán)限默認(rèn)授予 public 角色。
示例
下面的示例打開一個全局游標(biāo)，并使用 sp_cursor_list 報告游標(biāo)的特性。
相關(guān)文章USE Northwind
GO
-- Declare and open a keyset-driven cursor.
DECLARE abc CURSOR KEYSET FOR
SELECT LastName
FROM Employees
WHERE LastName LIKE 'S%'
OPEN abc
-- Declare a cursor variable to hold the cursor output variable
-- from sp_cursor_list.
DECLARE @Report CURSOR
-- Execute sp_cursor_list into the cursor variable.
EXEC master.dbo.sp_cursor_list @cursor_return = @Report OUTPUT,
@cursor_scope = 2
-- Fetch all the rows from the sp_cursor_list output cursor.
FETCH NEXT from @Report
WHILE (@@FETCH_STATUS <> -1)
BEGIN
FETCH NEXT from @Report
END
-- Close and deallocate the cursor from sp_cursor_list.
CLOSE @Report
DEALLOCATE @Report
GO
-- Close and deallocate the original cursor.
CLOSE abc
DEALLOCATE abc
GO
本頁查看次數(shù): - Transact-SQL 服務(wù)器游標(biāo)。