未使用 SQL 指南计划？

Question

我试图在一个简单的临时 SQL 查询上强制参数化。如本文中所述https://www.simple-talk.com/sql/performance/fixing-cache-bloat-problems-with-guide-plans-强制参数化/

但即使试图用最简单的查询来做到这一点，我也无法让它工作

CREATE TABLE fruit
(
 id BIGINT PRIMARY KEY(id)
,title VARCHAR(150)
)
INSERT INTO fruit VALUES ( 1, 'Apple') , ( 2, 'Banana'), ( 3, 'Orange'), ( 4, 'Pear')

DECLARE @params nvarchar(max);
DECLARE @stmt nvarchar(max);
EXEC sp_get_query_template N'SELECT title FROM fruit WHERE id = 4',@stmt OUTPUT, @params OUTPUT;

--SELECT @params
EXEC sp_create_plan_guide 
    N'fruitGuide', 
    @stmt, 
    N'TEMPLATE', 
    NULL, 
    @params, 
    N'OPTION(PARAMETERIZATION FORCED)';
GO

SELECT title FROM fruit WHERE id = 1

计划 XML：

显示编译并且不使用计划指南，我在这里遗漏了什么吗？我哪里出错了？

<?xml version="1.0" encoding="utf-16"?>
<ShowPlanXML xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" Version="1.5" Build="13.0.1601.5" xmlns="http://schemas.microsoft.com/sqlserver/2004/07/showplan">
  <BatchSequence>
    <Batch>
      <Statements>
        <StmtSimple StatementCompId="1" StatementEstRows="1" StatementId="1" StatementOptmLevel="TRIVIAL" CardinalityEstimationModelVersion="130" StatementSubTreeCost="0.0032831" StatementText="select title from fruit where id = @0" StatementType="SELECT" QueryHash="0xC02C3539A6CB7253" QueryPlanHash="0x257948D9E7B502E7" RetrievedFromCache="true" SecurityPolicyApplied="false">
          <StatementSetOptions ANSI_NULLS="true" ANSI_PADDING="true" ANSI_WARNINGS="true" ARITHABORT="true" CONCAT_NULL_YIELDS_NULL="true" NUMERIC_ROUNDABORT="false" QUOTED_IDENTIFIER="true" />
          <QueryPlan DegreeOfParallelism="1" CachedPlanSize="16" CompileTime="1" CompileCPU="1" CompileMemory="104">
            <MemoryGrantInfo SerialRequiredMemory="0" SerialDesiredMemory="0" />
            <OptimizerHardwareDependentProperties EstimatedAvailableMemoryGrant="256000" EstimatedPagesCached="64000" EstimatedAvailableDegreeOfParallelism="2" />
            <RelOp AvgRowSize="86" EstimateCPU="0.0001581" EstimateIO="0.003125" EstimateRebinds="0" EstimateRewinds="0" EstimatedExecutionMode="Row" EstimateRows="1" LogicalOp="Clustered Index Seek" NodeId="0" Parallel="false" PhysicalOp="Clustered Index Seek" EstimatedTotalSubtreeCost="0.0032831" TableCardinality="4">
              <OutputList>
                <ColumnReference Database="[DV]" Schema="[dbo]" Table="[fruit]" Column="title" />
              </OutputList>
              <RunTimeInformation>
                <RunTimeCountersPerThread Thread="0" ActualRows="1" ActualRowsRead="1" Batches="0" ActualEndOfScans="1" ActualExecutions="1" ActualExecutionMode="Row" ActualElapsedms="0" ActualCPUms="0" ActualScans="0" ActualLogicalReads="2" ActualPhysicalReads="0" ActualReadAheads="0" ActualLobLogicalReads="0" ActualLobPhysicalReads="0" ActualLobReadAheads="0" />
              </RunTimeInformation>
              <IndexScan Ordered="true" ScanDirection="FORWARD" ForcedIndex="false" ForceSeek="false" ForceScan="false" NoExpandHint="false" Storage="RowStore">
                <DefinedValues>
                  <DefinedValue>
                    <ColumnReference Database="[DV]" Schema="[dbo]" Table="[fruit]" Column="title" />
                  </DefinedValue>
                </DefinedValues>
                <Object Database="[DV]" Schema="[dbo]" Table="[fruit]" Index="[PK__fruit__3213E83F1B7D3288]" IndexKind="Clustered" Storage="RowStore" />
                <SeekPredicates>
                  <SeekPredicateNew>
                    <SeekKeys>
                      <Prefix ScanType="EQ">
                        <RangeColumns>
                          <ColumnReference Database="[DV]" Schema="[dbo]" Table="[fruit]" Column="id" />
                        </RangeColumns>
                        <RangeExpressions>
                          <ScalarOperator ScalarString="CONVERT_IMPLICIT(bigint,[@0],0)">
                            <Convert DataType="bigint" Style="0" Implicit="true">
                              <ScalarOperator>
                                <Identifier>
                                  <ColumnReference Column="@0" />
                                </Identifier>
                              </ScalarOperator>
                            </Convert>
                          </ScalarOperator>
                        </RangeExpressions>
                      </Prefix>
                    </SeekKeys>
                  </SeekPredicateNew>
                </SeekPredicates>
              </IndexScan>
            </RelOp>
            <ParameterList>
              <ColumnReference Column="@0" ParameterCompiledValue="(1)" ParameterRuntimeValue="(1)" />
            </ParameterList>
          </QueryPlan>
        </StmtSimple>
      </Statements>
    </Batch>
  </BatchSequence>
</ShowPlanXML>

Answer 1

正在应用您的计划指南，并且正在强制参数化查询。

不幸的是，这在您的特定情况下并不容易看到，原因如下：

原因 1：执行后计划不显示计划指南属性

查看您的查询是否使用计划指南的一种快速可靠的方法是请求执行前（估计）计划。

因此，在不运行查询的情况下，SSMS 中显示的执行计划将具有一个具有两个额外属性的根节点（与问题中提供的计划相比）：

这些属性不会出现在执行后计划中，也不会出现在准备好的缓存计划中。

边注

在您提供的执行后（实际）计划中，强制参数化的唯一（未记录）指示是第一个参数标记@0位于 Seek 工具提示中：

如果没有计划指南，您的测试查询仍然符合简单参数化的条件，但工具提示中的参数标记为@1：

原因 2：您已optimize for ad hoc workloads启用

启用此配置选项后，第一次运行即席查询时，不会缓存任何计划，只有计划存根。

您需要运行查询两次才能看到填充的计划存根。

仍然不会有一个完整的计划（只是一个SELECT 根节点），但这个节点将填充TemplatePlanGuideDB和TemplatePlanGuideName属性：

另请注意，该ParameterizedPlanHandle属性指向缓存中完全参数化（准备好的）查询计划的计划句柄。如前所述，准备好的计划不包含额外的计划指南属性。

如果没有该adhoc选项，临时编译的计划将显示重要的计划指南属性。