Указание направления параметра

Изменения: 17 июля 2006 г.

В качестве направления параметра может быть указан либо вход, что означает, что значение передается в хранимую процедуру, либо выход, что означает, что хранимая процедура возвращает значение в вызывающую программу через выходной параметр. По умолчанию, параметр определен как входной.

Для указания выходного параметра в определении хранимой процедуры для этого параметра необходимо указать ключевое слово OUTPUT. Хранимая процедура, завершая свою работу, возвращает текущее значение выходного параметра в вызывающую программу. При выполнении хранимой процедуры вызывающая программа также должна использовать ключевое слово OUTPUT для сохранения значения параметра в переменной, которое затем может быть использовано в вызывающей программе. Дополнительные сведения см. в разделе Возвращение данных с помощью параметров OUTPUT.

Примеры

В следующем примере создается хранимая процедура Production.usp_GetList, которая возвращает список продуктов, стоимость которых не превышает заданного значения. На данном примере демонстрируется использование нескольких инструкций SELECT и нескольких параметров OUTPUT. Параметры OUTPUT позволяют внешней процедуре, пакету или нескольким инструкциям Transact-SQL осуществлять доступ к набору значений во время выполнения процедуры.

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

Выполните процедуру usp_GetList для возврата списка продуктов компании Adventure Works (велосипедов), стоимость которых не более 700 долларов. Параметры OUTPUT @cost и @compareprices используются совместно с конструкциями языка управления потоком для возврата сообщения в окно Сообщения.

Примечание.
Переменная OUTPUT должна быть определена во время создания процедуры, а также при использовании переменной. Имена параметра и переменной не должны совпадать. Однако тип данных и положение параметра должны быть одинаковы (если только не используется @listprice= variable).

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)))+'.'

Частичный результирующий набор:

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.

См. также

Основные понятия

Указание имени аргумента
Типы данных параметров
Указание значения параметра по умолчанию

Другие ресурсы

Указание параметров

Справка и поддержка

Получение помощи по SQL Server 2005

Журнал изменений

Версия	Журнал
17 июля 2006 г.	Изменения Исправлен пример.