아티클
09/27/2010

sp_get_query_template(Transact-SQL)

매개 변수가 있는 쿼리 형식을 반환합니다. 반환된 결과는 강제 매개 변수화를 사용하여 얻은 매개 변수가 있는 쿼리 형식과 유사합니다. TEMPLATE 계획 지침을 만들 때는 주로 sp_get_query_template을 사용합니다.

항목 링크 아이콘 Transact-SQL 구문 표기 규칙

구문

sp_get_query_template
   [ @querytext = ] N'query_text'
      , @templatetext OUTPUT 
      , @parameters OUTPUT

인수

'query_text'
매개 변수가 있는 버전을 생성할 쿼리입니다. 'query_text'는 작은따옴표로 묶고 앞에 N 유니코드 지정자를 사용해야 합니다. N'query_text'는 @querytext 매개 변수에 할당된 값입니다. 형식은 nvarchar(max)입니다.
@templatetext
매개 변수가 있는 형식의 query_text를 문자열 리터럴로 얻기 위한 nvarchar(max) 형식의 출력 매개 변수이며 표시된 바와 같이 제공됩니다.
@parameters
@templatetext에서 매개 변수가 있는 데이터 형식 및 매개 변수 이름을 문자열 리터럴로 얻기 위한 nvarchar(max) 형식의 출력 매개 변수이며 표시된 바와 같이 제공됩니다.

주의

다음 경우 sp_get_query_template은 오류를 반환합니다.

query_text의 모든 상수 리터럴 값에 매개 변수가 없는 경우
query_text가 NULL이거나, 유니코드 문자열이 아니거나, 구문상 유효하지 않거나, 컴파일할 수 없는 경우

sp_get_query_template은 오류를 반환할 경우 @templatetext 및 @parameters 출력 매개 변수의 값을 수정하지 않습니다.

사용 권한

public 데이터베이스 역할의 멤버여야 합니다.

예

다음 예에서는 두 상수 리터럴 값이 포함된 쿼리를 매개 변수가 있는 형식으로 반환합니다.

USE AdventureWorks;
GO
DECLARE @my_templatetext nvarchar(max)
DECLARE @my_parameters nvarchar(max)
EXEC sp_get_query_template 
    N'SELECT pi.ProductID, SUM(pi.Quantity) AS Total
        FROM Production.ProductModel pm 
        INNER JOIN Production.ProductInventory pi
        ON pm.ProductModelID = pi.ProductID
        WHERE pi.ProductID = 2
        GROUP BY pi.ProductID, pi.Quantity
        HAVING SUM(pi.Quantity) > 400',
@my_templatetext OUTPUT,
@my_parameters OUTPUT;
SELECT @my_templatetext;
SELECT @my_parameters;

@my\_templatetextOUTPUT 매개 변수의 매개 변수가 있는 결과는 다음과 같습니다.

select pi . ProductID , SUM ( pi . Quantity ) as Total

from Production . ProductModel pm

inner join Production . ProductInventory pi

on pm . ProductModelID = pi . ProductID

where pi . ProductID = @0

group by pi . ProductID , pi . Quantity

having SUM ( pi . Quantity ) > 400

첫 번째 상수 리터럴 2는 매개 변수로 변환됩니다. 두 번째 리터럴 400은 HAVING 절 안에 있으므로 매개 변수로 변환되지 않습니다. sp_get_query_template에 의해 반환된 결과는 ALTER DATABASE의 PARAMETERIZATION 옵션이 FORCED로 설정된 경우의 매개 변수가 있는 쿼리 형식과 유사합니다. 이러한 조건에서 매개 변수가 있는 변수에 대한 자세한 내용은 강제 매개 변수화를 참조하십시오.

@my\_parameters OUTPUT 매개 변수의 매개 변수가 있는 결과는 다음과 같습니다.

@0 int

[!참고]

sp_get_query_template의 출력에서 매개 변수의 순서와 이름은 SQL Server의 QFE(Quick-Fix Engineering), 서비스 팩 및 버전 업그레이드에 따라 변경될 수 있습니다. 또한 업그레이드를 수행하면 다른 상수 리터럴 집합은 같은 쿼리에 대한 매개 변수가 있을 수 있고 두 출력 매개 변수의 결과에 다른 간격이 적용될 수 있습니다.