sp_cursorprepexec（Transact-SQL）

适用于：SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse Analytics分析平台系统 （PDW）Microsoft Fabric 预览版中的 SQL 数据库

为提交的游标语句或批处理编译计划，然后创建并填充游标。 sp_cursorprepexec 合并 sp_cursorprepare 和 sp_cursorexecute. 此过程通过在表格数据流 （TDS） 数据包中指定 ID = 5 来调用。

Transact-SQL 语法约定

语法

sp_cursorprepexec prepared handle OUTPUT , cursor OUTPUT , params , statement , options
    [ , scrollopt [ , ccopt [ , rowcount ] ] ]
    [ , '@parameter_name [ , ...n ]' ]

参数

准备句柄

SQL Server 生成的 已准备句柄 标识符。 准备的句柄参数是必需的，并返回 int。

cursor

SQL Server 生成的 游标 标识符。 游标参数是必须针对此游标执行的所有后续过程提供的必需参数，sp_cursorfetch例如。

params

标识参数化语句。 变量的参数定义将替换为语句中的参数标记。 参数是必需的。 指定后， 参数 将调用 ntext、 nchar 或 nvarchar 输入值。

语句

定义游标结果集。 语句参数是必需的，并调用 ntext、nchar 或 nvarchar 输入值。

options

一个可选参数，它返回游标结果集列的说明。 options 参数需要以下 int 输入值。

scrollopt

滚动选项。 scrollopt 参数是可选的。 指定后， scrollopt 需要以下 int 输入值之一。

由于请求的选项可能不适合由 语句定义的游标，因此此参数同时用作输入和输出。 在这种情况下，SQL Server 分配适当的类型并修改此值。

ccopt

并发控制选项。 ccopt 参数是可选的。 指定后， ccopt 参数需要以下 int 输入值之一。

与 scrollopt 一样，SQL Server 可以分配不同于所请求的值。

rowcount

一个可选参数，表示要用于 AUTO_FETCH的提取缓冲区行数。 默认值为 20 行。 当分配为输入值与返回值时， 行计数 参数的行为方式不同。

parameter_name

指定参数参数中定义的一个或多个参数名称。 必须为参数中包含的每个参数提供一个参数。 如果 参数 中的 Transact-SQL 语句或批处理未定义任何参数，则不需要此参数。

返回代码值

如果 参数 值返回 NULL，则语句不会参数化。

示例

此示例演示了 sp_cursorprepexec如何使用 。 它针对数据库中的 Person 表 AdventureWorks2022 运行查询，返回名字为“Kirby”的所有记录。

USE AdventureWorks2022;
GO

DECLARE @prep_handle INT,
    @cursor INT,
    @scrollopt INT = 4104,
    @ccopt INT = 8193,
    @rowcnt INT;

EXECUTE sp_cursorprepexec
    @prep_handle OUTPUT,
    @cursor OUTPUT,
    N'@fName nvarchar(100)',
    N'SELECT FirstName, LastName FROM Person.Person WHERE FirstName = @fName',
    @scrollopt,
    @ccopt,
    @rowcnt OUTPUT,
    'Kirby';

EXECUTE sp_cursorfetch @cursor;

相关内容

• sp_cursoropen （Transact-SQL）
• sp_cursorexecute （Transact-SQL）
• sp_cursorprepare （Transact-SQL）
• sp_cursorfetch （Transact-SQL）
• 系统存储过程 (Transact-SQL)