sp_recompile (Transact-SQL)
適用対象: 
SQL Server Azure SQL Database Azure SQL Managed Instance
ストアド プロシージャ、トリガー、およびユーザー定義関数を次回実行する際に再コンパイルします。 これを行うには、プロシージャ キャッシュから既存のプランを削除し、次にプロシージャまたはトリガーを実行する際に新しいプランを強制的に作成します。 SQL Server プロファイラー コレクションでは、イベント SP:Recompileの代わりにイベント SP:CacheInsertがログに記録されます。
構文
sp_recompile [ @objname = ] N'object'
[ ; ]
引数
[ @objname = ] N'object'
現在のデータベースにあるストアド プロシージャ、トリガー、テーブル、ビュー、またはユーザー定義関数の修飾名または非修飾名を指定します。 @objname は nvarchar(776)で、既定値はありません。
@objnameがストアド プロシージャ、トリガー、またはユーザー定義関数の名前である場合、ストアド プロシージャ、トリガー、または関数は次回実行されるときに再コンパイルされます。
@objnameがテーブルまたはビューの名前である場合、テーブルまたはビューを参照するすべてのストアド プロシージャ、トリガー、またはユーザー定義関数は、次回実行されるときに再コンパイルされます。
リターン コードの値
0 (成功) または 0 以外の数値 (失敗)。
解説
sp_recompile は、現在のデータベース内のオブジェクトのみを検索します。
ストアド プロシージャ、トリガー、およびユーザー定義関数によって使用されるクエリは、コンパイルされたときにのみ最適化されます。 インデックスまたはその他の統計に影響を与える変更がデータベースに対して行われると、コンパイルされたストアド プロシージャ、トリガー、およびユーザー定義関数の効率が低下する可能性があります。 そのテーブルに作用するストアド プロシージャやトリガーを再コンパイルすることにより、クエリを再び最適化できます。
通常、このストアド プロシージャのプロアクティブな実行は不要です。 SQL Server では、ストアド プロシージャ、トリガー、およびユーザー定義関数が有利な場合に自動的に再コンパイルされます。 データベース エンジンがオブジェクトの再コンパイルを選択する理由はさまざまです。 ほとんどの場合、自動再コンパイルは、統計の自動更新または手動更新により、基になるカーディナリティ推定の変更に従います。
すべての実行でストアド プロシージャを再コンパイルすることは、パラメーター化によって引き起こされるクエリ プランの問題に対処するための効率の低い方法の 1 つです。 SQL Server 2022 (16.x) で導入された機能 パラメーターの機密プランの最適化 は、この問題を自動的に軽減しようとします。 以前のバージョンでは、各実行で sp_recompile を呼び出す代わりに、次のことを検討してください。
- WITH RECOMPILE オプションをクエリに追加し、コードを変更する必要があります。
- プラン ガイドを使用して
WITH RECOMPILEオプションを適用。 - コードを変更せずにクエリ ストアヒントを使用して
WITH RECOMPILEオプションを適用します。 - 詳細については、「 パラメーターに依存するプランの問題を含むクエリを解決する」を参照してください。
アクセス許可
指定したオブジェクトに対する ALTER 権限が必要です。
例
次の例では、 Sales.Customer テーブルに対して動作するストアド プロシージャ、トリガー、およびユーザー定義関数を次回実行する際に再コンパイルします。
USE AdventureWorks2022;
GO
EXEC sp_recompile N'Sales.Customer';
GO