报告当前为连接打开的服务器游标的特性。

语法

sp_cursor_list [ @cursor_return = ] cursor_variable_name OUTPUT

    , [ @cursor_scope = ] cursor_scope

参数

[@cursor_return =] cursor_variable_name OUTPUT

声明的游标变量的名称。cursor_variable_name 的数据类型为 cursor，没有默认值。游标是可滚动的、动态的只读游标。

[@cursor_scope =] cursor_scope

指定要报告的游标级别。cursor_scope 的数据类型为 int，没有默认值，可以是下列值中的一个。

返回代码值

无

返回的游标

sp_cursor_list 返回的报告是 Transact-SQL 游标输出参数，而不是结果集。这样，Transact-SQL 批处理、存储过程和触发器就得以按一次一行的方式处理输出。这还意味着无法直接从数据库 API 函数调用该过程。游标输出参数必须绑定到程序变量，但是数据库 API 不支持绑定游标参数或变量。

以下是 sp_cursor_list 返回的游标格式。游标格式与 sp_describe_cursor 返回的格式相同。

注释

sp_cursor_list 生成连接打开的当前服务器游标列表，并描述每个游标的全局特性，例如游标的可滚动性和可更新性。sp_cursor_list 列出的游标包括：

• Transact-SQL 服务器游标。
  
  



• API 服务器游标，由 ODBC 应用程序打开，然后调用 SQLSetCursorName 给游标命名。

使用 sp_describe_cursor_columns 描述由游标返回的结果集的特性。使用 sp_describe_cursor_tables 报告游标引用的基表。sp_describe_cursor 与 sp_cursor_list 报告的信息相同，但前者只适用于指定的游标。

权限

执行权限默认授予 public 角色。

示例

下面的示例打开一个全局游标，并使用 sp_cursor_list 报告游标的特性。

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