sp_prepare (Transact SQL)

准备参数化的 Transact-SQL 语句并返回用于执行的语句“句柄”。 sp_prepare 通过在表格格式数据流 (TDS) 包中指定 ID = 11 来调用。

主题链接图标 Transact-SQL 语法约定

语法

sp_prepare handle OUTPUT, params, stmt, options

参数

  • handle
    是 SQL Server 生成的“已准备的句柄”标识符。 handle 是一个具有 int 返回值的必需参数。

  • params
    标识参数化语句。 变量的 params 定义替换为语句中的参数标记。 params 是一个必需参数,它需要 ntext、nchar 或nvarchar 输入值。 如果语句未参数化,则输入一个 NULL 值。

  • stmt
    定义游标结果集。 stmt 参数是必需的,它需要 ntext、nchar 或 nvarchar 输入值。

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

    说明

    0x0001

    RETURN_METADATA

示例

下面的示例准备并执行一个简单的语句。

Declare @P1 int;
Exec sp_prepare @P1 output, 
    N'@P1 nvarchar(128), @P2 nvarchar(100)',
    N'SELECT database_id, name FROM sys.databases WHERE name=@P1 AND state_desc = @P2';
Exec sp_execute @P1, N'tempdb', N'ONLINE';
EXEC sp_unprepare @P1;

请参阅

参考

系统存储过程 (Transact-SQL)