sp_prepare (Transact SQL)

準備參數化 Transact-SQL 陳述式並傳回要執行的陳述式「控制代碼」(Handle)。 sp_prepare 的叫用方式是在表格式資料流 (TDS) 封包中指定 ID = 11。

Transact-SQL 語法慣例

語法

sp_prepare handle OUTPUT, params, stmt, options

引數

• handle
  這是 SQL Server 產生的「已備妥控制代碼」(Prepared handle) 識別碼。 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)