sp_describe_cursor_tables (Transact-SQL)
适用范围：
SQL Server
报告由服务器游标引用的对象或基表。
语法
sp_describe_cursor_tables
[ @cursor_return = ] cursor_return OUTPUT
, [ @cursor_source = ] { N'local' | N'global' | N'*cursor_source*' }
, [ @cursor_identity = ] N'cursor_identity'
[ ; ]
参数
[ @cursor_return = ] cursor_return OUTPUT
要接收游标输出的声明游标变量的名称。 @cursor_return是一个 OUTPUT 游标，没有默认值，在调用时sp_describe_cursor_tables不得与任何游标关联。 返回的游标是可滚动的动态只读游标。
[ @cursor_source = ] { N'local' |N'global' |N'cursor_source' }
指定使用以下哪一名称来指定所报告的游标：本地游标、全局游标或游标变量的名称。 @cursor_source为 nvarchar（30），没有默认值。
[ @cursor_identity = ] N'cursor_identity'
当@cursor_source为local时，@cursor_identity是由具有关键字的语句LOCAL创建的DECLARE CURSOR游标的名称，或者默认为LOCAL该名称。
当@cursor_source为global时，@cursor_identity是由具有关键字的语句GLOBAL创建的DECLARE CURSOR游标的名称，或者默认为GLOBAL该名称。 @cursor_identity也可以是 ODBC 应用程序打开的 API 服务器游标的名称，然后通过调用SQLSetCursorName来命名游标。
当 @cursor_source 时 variable， @cursor_identity 是与打开游标关联的游标变量的名称。
@cursor_identity为 nvarchar（128），没有默认值。
返回代码值
无。
返回的游标
sp_describe_cursor_tables 将其报表封装为 Transact-SQL 游标 输出参数。 这样，Transact-SQL 批处理、存储过程和触发器就可以一次处理一行输出。 这也意味着无法直接从 API 函数调用该过程。 游标输出参数必须绑定到程序变量，但 API 不支持绑定游标参数或变量。
下表显示了游标的格式，该游标由 sp_describe_cursor_tables.
| 列名称 | 数据类型 | 描述 |
|---|---|---|
table_owner |
sysname | 表所有者的用户 ID。 |
table_name |
sysname | 对象或基表的名称。 在 SQL Server 中，服务器游标始终返回用户指定的对象，而不是基表。 |
optimizer_hint |
smallint | 由以下一个或多个选项组成的位图： 1 = 行级锁定 （ ROWLOCK）4 = 页面级锁定 （ PAGELOCK）8 = 表锁 （ TABLOCK）16 = 排他表锁 （ TABLOCKX）32 = 更新锁 （ UPDLOCK）64 = 无锁 （ NOLOCK）128 = 快速第一行选项 （ FASTFIRST）4096 = 与 （ HOLDLOCK） 一起使用DECLARE CURSOR时读取可重复语义如果提供多个选项，系统将使用限制性最高的选项。 但是， sp_describe_cursor_tables 显示查询中指定的标志。 |
lock_type |
smallint | 为该游标的每个基表显式或隐式地请求的滚动锁类型。 该值可以是以下选项之一： 0 = 无 1 = 共享 3 = 更新 |
server_name |
sysname，可为 null | 驻留表的链接服务器的名称。 NULL使用时间或OPENROWSET使用时间OPENQUERY。 |
objectid |
int | 表的对象 ID。 0 何时 OPENQUERY 使用或 OPENROWSET 使用。 |
dbid |
int | 表所在的数据库的 ID。0 何时 OPENQUERY 使用或 OPENROWSET 使用。 |
dbname |
sysname， 可为 null | 表所在的数据库的名称。 NULL使用时间或OPENROWSET使用时间OPENQUERY。 |
注解
sp_describe_cursor_tables 描述服务器游标引用的基表。 有关游标返回的结果集属性的说明，请使用 sp_describe_cursor_columns。 有关游标的全局特征的说明，例如其可滚动性和可更新性，请使用 sp_describe_cursor。 若要获取在连接上可见的 Transact-SQL Server 游标的报表，请使用 sp_cursor_list。
权限
要求 公共 角色具有成员身份。
示例
下面的示例打开一个全局游标，用于 sp_describe_cursor_tables 报告游标引用的表。
USE AdventureWorks2022;
GO
-- Declare and open a global cursor.
DECLARE abc CURSOR KEYSET FOR
SELECT LastName
FROM Person.Person
WHERE LastName LIKE 'S%';
OPEN abc;
GO
-- Declare a cursor variable to hold the cursor output variable
-- from sp_describe_cursor_tables.
DECLARE @Report CURSOR;
-- Execute sp_describe_cursor_tables into the cursor variable.
EXEC master.dbo.sp_describe_cursor_tables
@cursor_return = @Report OUTPUT,
@cursor_source = N'global',
@cursor_identity = N'abc';
-- Fetch all the rows from the sp_describe_cursor_tables output cursor.
FETCH NEXT from @Report;
WHILE (@@FETCH_STATUS <> -1)
BEGIN
FETCH NEXT from @Report;
END
-- Close and deallocate the cursor from sp_describe_cursor_tables.
CLOSE @Report;
DEALLOCATE @Report;
GO
-- Close and deallocate the original cursor.
CLOSE abc;
DEALLOCATE abc;
GO