sp_get_query_template(Transact-SQL)

매개 변수가 있는 쿼리 형식을 반환합니다. 반환된 결과는 강제 매개 변수화를 사용한 매개 변수가 있는 형식의 쿼리 결과와 비슷합니다. sp_get_query_template은 주로 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 AdventureWorks2012;
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\_templatetext OUTPUT 매개 변수의 매개 변수가 있는 결과는 다음과 같습니다.

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), 서비스 팩 및 버전 업그레이드에 따라 변경될 수 있습니다. 또한 업그레이드를 수행하면 다른 상수 리터럴 집합은 같은 쿼리에 대한 매개 변수가 있을 수 있고 두 출력 매개 변수의 결과에 다른 간격이 적용될 수 있습니다.

참고 항목

참조

시스템 저장 프로시저(Transact-SQL)

데이터베이스 엔진 저장 프로시저(Transact-SQL)

개념

계획 지침을 사용하여 쿼리 매개 변수화 동작 지정