sp_prepexec (Transact-SQL)

  • Artigo

Aplica-se a:SQL Server

Prepara e executa uma instrução Transact-SQL parametrizada. sp_prepexec combina as funções de sp_prepare e sp_execute. Essa ação é chamada por ID =13 em um pacote TDS (fluxo de dados tabulares).

Convenções de sintaxe de Transact-SQL

Sintaxe

  
sp_prepexec handle OUTPUT, params , stmt  
    [ , bound param ] [ ,...n]]

Argumentos

handle
É o identificador de identificador 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 parâmetros de variáveis é substituída por marcadores de parâmetros na instrução. Params é um parâmetro obrigatório que chama um valor de entrada nText, NCAR 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 é obrigatório e chama um valor de entrada ntext, ncar ou nvarchar .

bound_param
Significa o uso opcional de parâmetros adicionais. bound_param solicita um valor de entrada de qualquer tipo de dados para designar os parâmetros adicionais em uso.

Exemplos

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

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

Confira também

sp_prepare (Transact SQL)
sp_execute (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)