Júlio Battisti Livros e Cursosa sua sala de aula na internet

Assim como podemos passar valores, na forma de parâmetros de entrada, também podemos receber valores do Stored Procedure, na forma de parâmetros de saída. Para definir que um parâmetro é de saída, basta colocar a palavra OUTPUT após a definição do tipo do parâmetro, como no exemplo a seguir:

CREATE PROCEDURE usp_ParamSaida @paramsaida  int OUTPUT

Podemos ter um ou mais parâmetros de saída. Nos comandos que definem o Stored Procedure atribuímos um valor ao parâmetro de saída, utilizando o comando SET. Ao ser executado o Stored Procedure, o SQL Server retorna o valor associado com um ou mais parâmetros de saída.

Vamos a um exemplo prático.

Exemplo: Criar um Stored Procedure que retorna o valor médio dos pedidos para um país que é passado como parâmetro de entrada. Criar o Stored Procedure no Banco de Dados NwindAccess, com o nome de usp_MédiaPedidosPaís.

Para criar o Stored Procedure usp_MédiaPedidosPaís, utilizamos o seguinte comando:

USE NwindAccess

GO

CREATE PROCEDURE usp_MédiaPedidosPaís

    @país     varchar(15),

    @média    float OUTPUT

AS

SET @média= (SELECT AVG(([Quantidade]*[PreçoUnitário]) * (1-[Desconto])) AS Media

       FROM [Pedidos]INNER JOIN [Detalhes do Pedido]

       ON [Pedidos].[NúmeroDoPedido] = [Detalhes do Pedido].[NúmeroDoPedido]

       WHERE  ([PaísDeDestino]=@país))

Observe que executamos um comando SELECT que calcula a média para o país passado no parâmetro de entrada @país. O resultado deste comando SELECT é atribuído à variável de saída @média. Vamos a execução deste Stored Procedure:

DECLARE @Resultado float

EXEC usp_MédiaPedidosPaís “Brasil”, @Resultado OUTPUT

PRINT (@Resultado)

Será retornado o seguinte resultado:

526.728

Algumas observações importantes, sobre este exemplo:

• Temos que especificar o parâmetro de saída tanto na criação como na execução do Stored Procedure, conforme indicado no exemplo:

EXEC usp_MédiaPedidosPaís “Brasil”, @Resultado OUTPUT

O Stored Procedure é executado e o valor de retorno é armazenado na variável @resultado. Depois utilizamos o comando Print para exibir o valor desta variável.

• O número máximo de parâmetros – incluindo parâmetros de entrada e saída – é 1024.

Agora execute o seguinte comando:

DECLARE @Resultado float

EXEC usp_MédiaPedidosPaís “EUA”, @Resultado OUTPUT

PRINT (@Resultado)

Será retornado o seguinte resultado:

697.684