Compartilhar via


sp_prepexec (Transact-SQL)

Prepara e executa uma instrução Transact-SQL parametrizada. sp_prepexec combina as funções de sp_prepare e sp_execute. Isso é invocado por ID = 13 em um pacote TDS.

Ícone de vínculo de tópico Convenções de sintaxe Transact-SQL

Sintaxe

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

Argumentos

  • handle
    É o identificador 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.

  • bound_param
    Significa o uso opcional de parâmetros adicionais. bound_param chama 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 @P1 int;
EXEC sp_prepexec @P1 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 @P1;

Consulte também

Referência

sp_prepare (Transact SQL)

sp_execute (Transact-SQL)

Procedimentos armazenados do sistema (Transact-SQL)