パラメータスニッフィング、埋め込み、およびRECOMPILEオプション

パラメータスニッフィングは、バッチがsp_executesqlを使用して再利用するために明示的にパラメータ化されている場合にも発生します。 。

例：

EXECUTE sys.sp_executesql
    N'
    SELECT
        P.ProductID,
        P.Name,
        TotalQty = SUM(TH.Quantity)
    FROM Production.Product AS P
    JOIN Production.TransactionHistory AS TH
        ON TH.ProductID = P.ProductID
    WHERE
        P.Name LIKE @NameLike
    GROUP BY
        P.ProductID,
        P.Name;
    ',
    N'@NameLike nvarchar(50)',
    @NameLike = N'K%';

オプティマイザは、@NameLikeのスニッフィングされた値に基づいて実行プランを選択します パラメータ。パラメータ値「K％」は、Productのごく少数の行に一致すると推定されます テーブルなので、オプティマイザはネストされたループ結合とキールックアップ戦略を選択します：

「[H-R]％」のパラメーター値（さらに多くの行に一致します）を使用してステートメントを再度実行すると、キャッシュされたパラメーター化されたプランが再利用されます。

EXECUTE sys.sp_executesql
    N'
    SELECT
        P.ProductID,
        P.Name,
        TotalQty = SUM(TH.Quantity)
    FROM Production.Product AS P
    JOIN Production.TransactionHistory AS TH
        ON TH.ProductID = P.ProductID
    WHERE
        P.Name LIKE @NameLike
    GROUP BY
        P.ProductID,
        P.Name;
    ',
    N'@NameLike nvarchar(50)',
    @NameLike = N'[H-R]%';

AdventureWorks サンプルデータベースは小さすぎてパフォーマンスを損なうことはありませんが、この計画は2番目のパラメータ値には確かに最適ではありません。

プランキャッシュをクリアし、2番目のクエリを再度実行することで、オプティマイザーが選択したプランを確認できます。

より多くの一致が予想されるため、オプティマイザーはハッシュ結合とハッシュ集約がより良い戦略であると判断します。

T-SQL関数

パラメータスニッフィングはT-SQL関数でも発生しますが、実行プランの生成方法によってこれがわかりにくくなる可能性があります。

一般にT-SQLスカラー関数とマルチステートメント関数を避けるのには十分な理由があるため、教育目的でのみ、テストクエリのT-SQLマルチステートメントテーブル値関数バージョンを次に示します。

CREATE FUNCTION dbo.F
    (@NameLike nvarchar(50))
RETURNS @Result TABLE
(
    ProductID   integer NOT NULL PRIMARY KEY,
    Name        nvarchar(50) NOT NULL,
    TotalQty    integer NOT NULL
)
WITH SCHEMABINDING
AS
BEGIN
    INSERT @Result
    SELECT
        P.ProductID,
        P.Name,
        TotalQty = SUM(TH.Quantity)
    FROM Production.Product AS P
    JOIN Production.TransactionHistory AS TH
        ON TH.ProductID = P.ProductID
    WHERE
        P.Name LIKE @NameLike
    GROUP BY
        P.ProductID,
        P.Name;
 
    RETURN;
END;

次のクエリは、関数を使用して、「K」で始まる製品名の情報を表示します。

SELECT
    Result.ProductID,
    Result.Name,
    Result.TotalQty
FROM dbo.F(N'K%') AS Result;

SQL Serverは、関数の呼び出しごとに個別の実行後（実際の）クエリプランを返さないため、埋め込み関数を使用してパラメーターのスニッフィングを確認することはより困難です。関数は1つのステートメント内で何度も呼び出すことができ、SSMSが1つのクエリに対して100万の関数呼び出しプランを表示しようとしても、ユーザーは感心しません。

この設計上の決定の結果として、テストクエリに対してSQLServerから返される実際の計画はあまり役に立ちません。

それにもかかわらず、 組み込み関数を使用して動作中のパラメータースニッフィングを確認する方法。ここで使用する方法として選択したのは、プランキャッシュを検査することです。

SELECT
    DEQS.plan_generation_num,
    DEQS.execution_count,
    DEQS.last_logical_reads,
    DEQS.last_elapsed_time,
    DEQS.last_rows,
    DEQP.query_plan
FROM sys.dm_exec_query_stats AS DEQS
CROSS APPLY sys.dm_exec_sql_text(DEQS.plan_handle) AS DEST
CROSS APPLY sys.dm_exec_query_plan(DEQS.plan_handle) AS DEQP
WHERE
    DEST.objectid = OBJECT_ID(N'dbo.F', N'TF');

この結果は、関数プランが1回実行され、論理読み取りが201回、経過時間が2891マイクロ秒であり、最新の実行で1行が返されたことを示しています。返されたXMLプラン表現は、パラメータ値がだったことを示しています。 スニッフィング：

次に、別のパラメーターを使用して、ステートメントを再度実行します。

SELECT
    Result.ProductID,
    Result.Name,
    Result.TotalQty
FROM dbo.F(N'[H-R]%') AS Result;

実行後の計画では、関数によって306行が返されたことが示されています：

プランキャッシュクエリは、関数のキャッシュされた実行プランが再利用されたことを示します（execution_count =2）：

また、前回の実行と比較して、論理読み取りの数がはるかに多く、経過時間が長くなっています。これは、ネストされたループとルックアッププランの再利用と一致しますが、完全に確実に、実行後の関数プランは拡張イベントを使用してキャプチャできます。 またはSQLServerプロファイラー ツール：

パラメータスニッフィングは関数に適用されるため、これらのモジュールは、ストアドプロシージャに一般的に関連するパフォーマンスの同じ予期しない変更に悩まされる可能性があります。

たとえば、関数が初めて参照されるときに、並列処理を使用しないプランがキャッシュされる場合があります。並列処理の恩恵を受ける（ただし、キャッシュされたシリアルプランを再利用する）パラメーター値を使用した後続の実行では、パフォーマンスが予期せず低下します。

これまで見てきたように、SQL Serverは関数呼び出しに対して個別の実行後プランを返さないため、この問題を特定するのは難しい場合があります。 拡張イベントの使用 またはプロファイラー 実行後の計画を定期的にキャプチャすることは、非常に多くのリソースを消費する可能性があるため、その手法を非常に的を絞った方法で使用することはしばしば理にかなっています。関数のパラメーター感度の問題をデバッグすることの難しさは、関数が本番環境に到達する前に分析（および防御的なコーディング）を行う価値があることを意味します。

パラメータスニッフィングは、T-SQLスカラーユーザー定義関数とまったく同じように機能します（インラインでない限り、SQL Server 2019以降）。インラインテーブル値関数は、（名前が示すように）コンパイル前に呼び出し元のクエリにインライン化されるため、呼び出しごとに個別の実行プランを生成しません。

SELECT
    Result.ProductID,
    Result.Name,
    Result.TotalQty
FROM dbo.F(N'K%') AS Result;

SELECT 
    A.AddressLine1, 
    A.City, 
    A.PostalCode 
FROM Person.Address AS A 
WHERE 
    A.AddressLine1 = N'Heidestieg Straße 8664';

SELECT 
    A.AddressLine1, 
    A.City, 
    A.PostalCode 
FROM Person.Address AS A 
WHERE 
    A.AddressLine1 = N'Winter der Böck 8550';

DBCC FREEPROCCACHE;
DBCC TRACEON (4136);
GO
SELECT
    A.AddressLine1, 
    A.City, 
    A.PostalCode 
FROM Person.Address AS A 
WHERE
    A.AddressLine1 = N'Heidestieg Straße 8664';
GO
SELECT 
    A.AddressLine1, 
    A.City, 
    A.PostalCode 
FROM Person.Address AS A 
WHERE 
    A.AddressLine1 = N'Winter der Böck 8550';
GO
DBCC TRACEOFF (4136);

WITH XMLNAMESPACES
    (DEFAULT 'http://schemas.microsoft.com/sqlserver/2004/07/showplan')
SELECT
    DECP.cacheobjtype,
    DECP.objtype,
    DECP.usecounts,
    DECP.plan_handle,
    parameterized_plan_handle =
        DEQP.query_plan.value
        (
            '(//StmtSimple)[1]/@ParameterizedPlanHandle',
            'NVARCHAR(100)'
        )
FROM sys.dm_exec_cached_plans AS DECP
CROSS APPLY sys.dm_exec_sql_text(DECP.plan_handle) AS DEST
CROSS APPLY sys.dm_exec_query_plan(DECP.plan_handle) AS DEQP
WHERE 
    DEST.[text] LIKE N'%AddressLine1%'
    AND DEST.[text] NOT LIKE N'%XMLNAMESPACES%';

CREATE PROCEDURE dbo.P
    @NameLike nvarchar(50),
    @Sort tinyint
WITH RECOMPILE
AS
BEGIN
    SELECT TOP (5)
        ProductID,
        Name
    FROM Production.Product
    WHERE
        @NameLike IS NULL
        OR Name LIKE @NameLike
    ORDER BY
        CASE WHEN @Sort = 1 THEN ProductID ELSE NULL END ASC,
        CASE WHEN @Sort = 2 THEN ProductID ELSE NULL END DESC,
        CASE WHEN @Sort = 3 THEN Name ELSE NULL END ASC,
        CASE WHEN @Sort = 4 THEN Name ELSE NULL END DESC;
END;

EXECUTE dbo.P
	@NameLike = N'K%',
	@Sort = 1;
GO
EXECUTE dbo.P
	@NameLike = N'[H-R]%',
	@Sort = 4;

CREATE PROCEDURE dbo.P
    @NameLike nvarchar(50),
    @Sort tinyint
AS
BEGIN
    SELECT TOP (5)
        ProductID,
        Name
    FROM Production.Product
    WHERE
        @NameLike IS NULL
        OR Name LIKE @NameLike
    ORDER BY
        CASE WHEN @Sort = 1 THEN ProductID ELSE NULL END ASC,
        CASE WHEN @Sort = 2 THEN ProductID ELSE NULL END DESC,
        CASE WHEN @Sort = 3 THEN Name ELSE NULL END ASC,
        CASE WHEN @Sort = 4 THEN Name ELSE NULL END DESC
    OPTION (RECOMPILE);
END;

SELECT TOP (5)
    ProductID,
    Name
FROM Production.Product
WHERE
    'K%' IS NULL
    OR Name LIKE 'K%'
ORDER BY
    CASE WHEN 1 = 1 THEN ProductID ELSE NULL END ASC,
    CASE WHEN 1 = 2 THEN ProductID ELSE NULL END DESC,
    CASE WHEN 1 = 3 THEN Name ELSE NULL END ASC,
    CASE WHEN 1 = 4 THEN Name ELSE NULL END DESC;

SELECT TOP (5)
    ProductID,
    Name
FROM Production.Product
WHERE
    Name LIKE 'K%'
ORDER BY
    ProductID ASC,
    NULL DESC,
    NULL ASC,
    NULL DESC;

CREATE PROCEDURE dbo.P
    @NameLike nvarchar(50),
    @Sort tinyint
AS
BEGIN
    DECLARE
        @ProductID integer,
        @Name nvarchar(50);
 
    SELECT TOP (1)
        @ProductID = ProductID,
        @Name = Name
    FROM Production.Product
    WHERE
        @NameLike IS NULL
        OR Name LIKE @NameLike
    ORDER BY
        CASE WHEN @Sort = 1 THEN ProductID ELSE NULL END ASC,
        CASE WHEN @Sort = 2 THEN ProductID ELSE NULL END DESC,
        CASE WHEN @Sort = 3 THEN Name ELSE NULL END ASC,
        CASE WHEN @Sort = 4 THEN Name ELSE NULL END DESC
    OPTION (RECOMPILE);
END;