使用 SQL Server Profiler 创建和测试计划指南

  • 项目

适用于：SQL ServerAzure SQL 数据库

创建计划指南时，可以使用 SQL Server Profiler 捕获确切的查询文本，以便在sp_create_plan_guide存储过程的 statement_text 参数中使用。 这有助于确保计划指南在编译时与查询匹配。 创建计划指南后，SQL Server Profiler还可用于测试计划指南是否实际上与查询匹配。 通常，应使用SQL Server Profiler来测试计划指南，以验证查询是否与计划指南匹配。

使用 SQL Server Profiler 捕获查询文本

如果使用 SQL Server Profiler 运行查询并捕获提交到SQL Server的文本，则可以创建与查询文本完全匹配的 SQL 或 TEMPLATE 类型的计划指南。 这将确保计划指南可由查询优化器使用。

思考以下作为独立批处理由应用程序提交的查询：

SELECT COUNT(*) AS c  
FROM Sales.SalesOrderHeader AS h  
INNER JOIN Sales.SalesOrderDetail AS d  
  ON h.SalesOrderID = d.SalesOrderID  
WHERE h.OrderDate BETWEEN '20000101' and '20050101';

假设您要通过合并联接操作执行此查询，但 SHOWPLAN 指示该查询未使用合并联接。 因为无法在应用程序中直接更改查询，所以可以改为创建计划指南来指定在编译时将 MERGE JOIN 查询提示追加到该查询。

若要捕获SQL Server接收查询的文本，请执行以下步骤：

  1. 启动SQL Server Profiler跟踪，确保选择 SQL：BatchStarting 事件类型。

  2. 使应用程序运行查询。

  3. 暂停SQL Server Profiler跟踪。

  4. 单击与该查询对应的 SQL:BatchStarting 事件。

  5. 右键单击并选择“提取事件数据”。

    重要

    不要尝试通过从事件探查器跟踪窗口的下窗格中选中批处理文本来复制它。 这可能会导致所创建的计划指南与原始批处理不匹配。

  6. 将事件数据保存到文件。 这就是批处理文本。

  7. 在记事本中打开该批处理文本文件，将文本复制到复制和粘贴缓冲区。

  8. 创建计划指南，并将复制的文本粘贴到为 @stmt 参数指定的引号 (“”) 内。 必须通过在 @stmt 参数前面加上另一个单引号来转义@stmt参数中的任何单引号。 插入这些单引号时务必小心，不要添加或删除任何其他字符。 例如，日期文本“20000101”必须分隔为“20000101”。

下面是该计划指南：

EXEC sp_create_plan_guide   
    @name = N'MyGuide1',  
    @stmt = N'<paste the text copied from the batch text file here>',  
    @type = N'SQL',  
    @module_or_batch = NULL,  
    @params = NULL,  
    @hints = N'OPTION (MERGE JOIN)';

使用 SQL Server Profiler 测试计划指南

若要验证计划指南是否与查询匹配，请执行以下步骤：

  1. 启动SQL Server Profiler跟踪，确保选择“Showplan XML”事件类型 (位于“性能”节点) 下。

  2. 使应用程序运行查询。

  3. 暂停SQL Server Profiler跟踪。

  4. 在 Showplan XML 事件中查找受影响的查询。

    注意

    无法使用 “查询编译的 Showplan XML” 事件。 PlanGuideDB 在该事件中不存在。

  5. 如果计划指南的类型为 OBJECT 或 SQL，则请验证 Showplan XML 事件是否包含您希望与查询匹配的计划指南的 PlanGuideDB 和 PlanGuideName 属性。 或者，如果计划指南的类型为 TEMPLATE，则请验证 Showplan XML 事件是否包含预期计划指南的 TemplatePlanGuideDB 和 TemplatePlanGuideName 属性。 这可以验证计划指南是否在运行。 这些属性包含在计划的 StmtSimple> 元素下<。

另请参阅

sp_create_plan_guide (Transact-SQL)