sp_get_query_template (Transact-SQL)

Syntaxe

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

Arguments

• 'query_text'
  Requête dont la version paramétrable doit être générée. 'query_text' doit être placé entre guillemets simples et précédé du spécificateur Unicode N. N'query_text' représente la valeur affectée au paramètre @querytext. Celui-ci est de type nvarchar(max).

• @templatetext
  Paramètre de sortie de type nvarchar(max), fourni tel qu'indiqué, permettant de recevoir la forme paramétrable de query_text en tant que littéral de chaîne.

• @parameters
  Paramètre de sortie de type nvarchar(max), fourni tel qu'indiqué, permettant de recevoir un littéral de chaîne des noms de paramètres et des types de données qui ont été paramétrables dans @templatetext.

Notes

sp_get_query_template retourne une erreur dans les cas suivants :

• Elle ne paramètre aucune valeur littérale de constante dans query_text.

• query_text a pour valeur NULL, n'est pas une chaîne Unicode, présente une syntaxe incorrecte ou ne peut pas être compilé.

Si sp_get_query_template retourne une erreur, elle ne modifie pas les valeurs des paramètres de sortie @templatetext et @parameters.

Autorisations

Nécessite l'appartenance au rôle de base de données public.

Exemples

L'exemple suivant retourne la forme paramétrable d'une requête qui contient deux valeurs littérales de constante.

USE AdventureWorks2008R2;
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;

Voici les résultats paramétrables du paramètre @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

Le premier littéral de constante, 2, est converti en un paramètre. Le second littéral, 400, n'est pas converti car il se trouve dans une clause HAVING. Les résultats retournés par sp_get_query_template simulent la forme paramétrable d'une requête lorsque l'option PARAMETERIZATION de ALTER DATABASE a pour valeur FORCED. Pour connaître les variables paramétrables dans ces conditions, consultez Paramétrage forcé.

Voici les résultats paramétrés du paramètre @my_parameters OUTPUT :

@0 int

Voir aussi

Référence

Concepts