sp_prepare (Transact SQL)

Prepara una instrucción Transact-SQL con parámetros y devuelve un identificador de instrucción para la ejecución. sp_prepare se invoca especificando el identificador 11 en un paquete de flujo TDS.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_prepare handle OUTPUT, params, stmt, options

Argumentos

• handle
  Es un identificador de handle preparado generado por SQL Server. handle es un parámetro necesario que devuelve un valor int.

• params
  Identifica instrucciones con parámetros. La definición del parámetro params de variables se sustituye para los marcadores de parámetros en la instrucción. El parámetro params es un parámetro necesario que requiere un valor de entrada ntext, nvarchar o nchar. Escriba un valor NULL si la instrucción no tiene parámetros.

• stmt
  Define el conjunto de resultados del cursor. El parámetro stmt es necesario y requiere un valor de entrada ntext, nchar o nvarchar.

• options
  Parámetro opcional que devuelve una descripción de las columnas del conjunto de resultados del cursor. options requiere el siguiente valor de entrada int.

  Valor	Descripción
  0x0001	RETURN_METADATA

Ejemplos

El siguiente ejemplo prepara y ejecuta una instrucción sencilla.

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;

Vea también

Referencia

Procedimientos almacenados del sistema (Transact-SQL)