sp_prepare (Transact SQL)

Prepara uma instrução Transact-SQL parametrizada e retorna um identificador de instrução para execução. sp_prepare é invocado especificando-se ID = 11 em um pacote TDS.

Convenções de sintaxe Transact-SQL

Sintaxe

sp_prepare handle OUTPUT, params, stmt, options

Argumentos

• handle
  É um identificador prepared handle gerado pelo SQL Server. handle é um parâmetro obrigatório com um valor de retorno int.

• params
  Identifica instruções parametrizadas. A definição de variáveis params é substituída pelos marcadores de parâmetro na instrução. params é um parâmetro obrigatório que chama um valor de entrada ntext, nchar ou nvarchar . Insira um valor NULL se a instrução não for parametrizada.

• stmt
  Define o conjunto de resultados do cursor. O parâmetro stmt é exigido e chama um valor de entrada ntext, nchar ou nvarchar.

• options
  Um parâmetro opcional que retorna uma descrição das colunas do conjunto de resultados de cursor. options exige o valor de entrada int a seguir.

  Valor	Descrição
  0x0001	RETURN_METADATA

Exemplos

O exemplo a seguir prepara e executa uma instrução simples.

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;

Consulte também

Referência

Procedimentos armazenados do sistema (Transact-SQL)