Especificando a direção de um parâmetro
A direção de um parâmetro é dentro, significando que um valor é passado para o parâmetro de entrada do procedimento armazenado, ou fora, significando que o procedimento armazenado retorna um valor ao programa de chamada por meio de um parâmetro de saída. O padrão é um parâmetro de entrada.
Para especificar um parâmetro de saída, você deverá indicar a palavra-chave OUTPUT na definição do parâmetro no procedimento armazenado. O procedimento armazenado retorna o valor atual do parâmetro de saída ao programa de chamada quando o procedimento armazenado existir. O programa de chamada deve também usar a palavra-chave OUTPUT quando for executar o procedimento armazenado a fim de salvar o valor do parâmetro em uma variável que poderá ser usada no programa de chamada. Para obter mais informações, consulte Retornando dados por meio de parâmetros OUTPUT.
Exemplos
O exemplo a seguir cria o procedimento armazenado Production.usp_GetList, que retorna uma lista dos produtos com preços que não excedam um valor especificado. O exemplo mostra o uso de várias instruções SELECT e vários parâmetros OUTPUT. Os parâmetros OUTPUT permitem que um procedimento externo, um lote ou mais de uma instrução Transact-SQL acessem um valor definido durante a execução do procedimento.
USE AdventureWorks;
GO
IF OBJECT_ID ( 'Production.uspGetList', 'P' ) IS NOT NULL
DROP PROCEDURE Production.uspGetList;
GO
CREATE PROCEDURE Production.uspGetList @Product varchar(40)
, @MaxPrice money
, @ComparePrice money OUTPUT
, @ListPrice money OUT
AS
SET NOCOUNT ON;
SELECT p.[Name] AS Product, p.ListPrice AS 'List Price'
FROM Production.Product AS p
JOIN Production.ProductSubcategory AS s
ON p.ProductSubcategoryID = s.ProductSubcategoryID
WHERE s.[Name] LIKE @Product AND p.ListPrice < @MaxPrice;
-- Populate the output variable @ListPprice.
SET @ListPrice = (SELECT MAX(p.ListPrice)
FROM Production.Product AS p
JOIN Production.ProductSubcategory AS s
ON p.ProductSubcategoryID = s.ProductSubcategoryID
WHERE s.[Name] LIKE @Product AND p.ListPrice < @MaxPrice);
-- Populate the output variable @compareprice.
SET @ComparePrice = @MaxPrice;
GO
Execute usp_GetList para retornar uma lista de produtos (bicicletas) da Adventure Works que custam menos que $ 700. Os parâmetros OUTPUT @cost e @ compareprices são usados com linguagem controle-de-fluxo para retornar uma mensagem na janela Mensagens.
![]() |
---|
A variável OUTPUT deve ser definida durante a criação do procedimento como também durante o uso da variável. O nome de parâmetro e o nome de variável não precisam coincidir. Porém, o tipo de dado e o posicionamento do parâmetro devem coincidir (a menos que @ listprice= variable seja usado). |
DECLARE @ComparePrice money, @Cost money
EXECUTE Production.uspGetList '%Bikes%', 700,
@ComparePrice OUT,
@Cost OUTPUT
IF @Cost <= @ComparePrice
BEGIN
PRINT 'These products can be purchased for less than
$'+RTRIM(CAST(@ComparePrice AS varchar(20)))+'.'
END
ELSE
PRINT 'The prices for all products in this category exceed
$'+ RTRIM(CAST(@ComparePrice AS varchar(20)))+'.'
Veja, a seguir, o conjunto parcial dos resultados:
Product List Price
-------------------------------------------------- ------------------
Road-750 Black, 58 539.99
Mountain-500 Silver, 40 564.99
Mountain-500 Silver, 42 564.99
...
Road-750 Black, 48 539.99
Road-750 Black, 52 539.99
(14 row(s) affected)
These items can be purchased for less than $700.00.
Consulte também