매개 변수 방향 지정

업데이트: 2006년 7월 17일

매개 변수의 방향은 값이 저장 프로시저 입력 매개 변수에 전달됨을 의미하는 in 또는 저장 프로시저가 출력 매개 변수를 통해 호출 프로그램에 값을 반환함을 의미하는 out입니다. 기본값은 입력 매개 변수입니다.

출력 매개 변수를 지정하려면 저장 프로시저의 매개 변수 정의에서 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를 실행하여 가격이 700달러 미만인 Adventure Works 제품(자전거) 목록을 반환합니다. @cost@compareprices OUTPUT 매개 변수는 흐름 제어 언어와 함께 사용되어 메시지 창에 메시지를 반환합니다.

[!참고] 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 지원 받기

변경 내역

릴리스 내역

2006년 7월 17일

변경된 내용
  • 예를 수정했습니다.