Ange beteende för frågeparameterisering med hjälp av planguider

gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

När du anger databasalternativet PARAMETERIZATION till SIMPLEkan SQL Server frågeoptimeraren välja att parameterisera frågorna. Den här parameteriseringen ersätter eventuella literalvärden i en fråga med parametrar. Den här processen kallas enkel parameterisering. När SIMPLE parameteriseringen är i kraft kan du inte styra vilka frågor som parametriseras och vilka frågor som inte är det. Du kan dock ange att alla frågor i en databas ska parametriseras genom att ange databasalternativet PARAMETERIZATION till FORCED. Den här processen kallas för tvingad parameterisering.

Du kan åsidosätta parameteriseringsbeteendet för en databas med hjälp av planguider på följande sätt:

Överväg följande fråga i AdventureWorks2025-databasen:

SELECT pi.ProductID,
       SUM(pi.Quantity) AS Total
FROM Production.ProductModel AS pm
     INNER JOIN Production.ProductInventory AS pi
         ON pm.ProductModelID = pi.ProductID
WHERE pi.ProductID = 101
GROUP BY pi.ProductID, pi.Quantity
HAVING SUM(pi.Quantity) > 50;

Som databasadministratör bestämmer du att du inte vill aktivera tvingad parameterisering för alla frågor i databasen. Du vill dock undvika kompileringskostnader för alla frågor som är syntaktiskt likvärdiga med den tidigare frågan, men som bara skiljer sig åt i sina konstanta literalvärden. Med andra ord vill du att frågan ska parametriseras så att en frågeplan för den här typen av fråga återanvänds. I det här fallet utför du följande steg:

1. Hämta frågans parametriserade form. Det enda säkra sättet att hämta det här värdet för användning i sp_create_plan_guide är att använda den systemlagrade proceduren sp_get_query_template.

2. Skapa planguiden för frågans parametriserade form och ange frågetipset PARAMETERIZATION FORCED .

   Viktig

   Som en del av parameteriseringen av en fråga tilldelar SQL Server en datatyp till parametrarna som ersätter literalvärdena, beroende på värdet och storleken på literalen. Samma process sker för värdet av de konstanta literaler som skickas till utparametern @stmt för sp_get_query_template. Eftersom datatypen som anges i @params argumentet sp_create_plan_guide måste matcha frågans som den parametriseras av SQL Server, kan du behöva skapa mer än en planguide för att täcka hela intervallet med möjliga parametervärden för frågan.

Följande skript kan användas både för att hämta den parametriserade frågan och sedan skapa en planguide för den:

DECLARE @stmt AS NVARCHAR (MAX);
DECLARE @params AS NVARCHAR (MAX);

EXECUTE sp_get_query_template
    N'SELECT pi.ProductID, SUM(pi.Quantity) AS Total
      FROM Production.ProductModel AS pm
      INNER JOIN Production.ProductInventory AS pi ON pm.ProductModelID = pi.ProductID
      WHERE pi.ProductID = 101
      GROUP BY pi.ProductID, pi.Quantity
      HAVING SUM(pi.Quantity) > 50',
@stmt OUTPUT, @params OUTPUT;

EXECUTE sp_create_plan_guide N'TemplateGuide1',
@stmt, N'TEMPLATE', NULL,
@params, N'OPTION(PARAMETERIZATION FORCED)';

Om tvingad parameterisering redan är aktiverad i databasen kan du åsidosätta den för specifika frågor. Om du vill parametrisera exempelfrågan och syntaktiskt likvärdiga frågor enligt enkla parameteriseringsregler anger du PARAMETERIZATION SIMPLE i stället för PARAMETERIZATION FORCED i OPTION -satsen.

Relaterat innehåll

• Arkitekturguide för frågebearbetning
• sp_create_plan_guide (Transact-SQL)