使用計劃指引指定查詢參數化行為

發行項
2025-03-05

適用於：SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體

當 PARAMETERIZATION 資料庫選項設定為 SIMPLE 時，SQL Server 查詢最佳化工具可能會選擇將查詢參數化。這意謂著任何包含在查詢中的常值將會以參數替代。此處理序稱為簡易參數化。當 SIMPLE 參數化生效時，您無法控制哪些查詢要參數化以及哪些查詢不要參數化。但是，您可以將 PARAMETERIZATION 資料庫選項設定為 FORCED，藉以指定要參數化資料庫中的所有查詢。此處理序稱為強制參數化。

您可以透過下列方式使用執行計劃指南來覆蓋資料庫的參數化行為：

當 PARAMETERIZATION 資料庫選項設定為 SIMPLE 時，您可以指定在特定的查詢類別強制參數化。作法是在查詢的參數化表單上建立 TEMPLATE 計畫指南，並在 sp_create_plan_guide 預存程序中指定 PARAMETERIZATION FORCED 查詢提示。您可以考慮將此類的計畫指南做為只在某類別的查詢 (而不是所有的查詢) 中啟用強制參數化的方式。如需簡單參數化的詳細資訊，請參閱查詢處理架構指南。
當 PARAMETERIZATION 資料庫選項設定為 FORCED 時，您可以指定在特定的查詢類別只嘗試簡單參數化，但不嘗試強制參數化。在查詢的強制參數化形式上建立模板計畫指南，並在 sp_create_plan_guide 中指定「PARAMETERIZATION SIMPLE」查詢提示。如需強制參數化的詳細資訊，請參閱查詢處理架構指南。

請考慮在 AdventureWorks2022 資料庫中的下列查詢：

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;

身為資料庫管理員，您已決定不要啟用資料庫中所有查詢的強制參數化。不過，您希望避免對那些在語法上與上一個查詢相同但僅常數字面值不同的所有查詢進行編譯成本。換句話說，您希望查詢被參數化，以便重新使用這類查詢的查詢計畫。在此情況下，請完成下列步驟：

擷取查詢的參數化格式。取得這個值供 sp_create_plan_guide 使用的唯一安全方法，是使用 sp_get_query_template 系統預存程序。
在參數化形式的查詢上制定計劃指南，指定 PARAMETERIZATION FORCED 查詢提示。

重要

將查詢參數化時，SQL Server 會將資料類型指派給取代常值的參數，取決於常值的值與大小。同樣的程序也會發生在傳遞給 sp_get_query_template 的 @stmt輸出參數之字面常數上。由於 sp_create_plan_guide 的 @params 引數中所指定的資料類型，在 SQL Server 將該查詢參數化時，必須符合查詢的資料類型，因此您必須建立一個或多個計畫指南，以涵蓋完整範圍的查詢可能參數值。

下列指令碼可用以擷取參數化查詢，並在該查詢上建立計畫指南：

DECLARE @stmt nvarchar(max);  
DECLARE @params nvarchar(max);  
EXEC 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;  
EXEC sp_create_plan_guide   
    N'TemplateGuide1',   
    @stmt,   
    N'TEMPLATE',   
    NULL,   
    @params,   
    N'OPTION(PARAMETERIZATION FORCED)';

相同的，在已經啟用強制參數化的資料庫中，您可以確定讓範例查詢以及其他句法相同的項目 (常數常值除外)，都根據簡單參數化規則加以參數化。作法是指定 OPTION 子句中的 PARAMETERIZATION SIMPLE，而不是 PARAMETERIZATION FORCED。

注意

TEMPLATE 計畫指南可使陳述式配合僅由單一陳述式組成的批次中所提交的查詢。 TEMPLATE 計畫指南無法配合多重陳述式批次中的陳述式。

共用方式為

使用計劃指引指定查詢參數化行為

意見反應

其他資源