sp_recompile (Transact-SQL)

適用対象: SQL Server (サポートされているすべてのバージョン) Azure SQL Database Azure SQL Managed Instance

ストアド プロシージャ、トリガー、およびユーザー定義関数が次回実行時に再コンパイルされるようにします。 これは、プロシージャまたはトリガーが次回実行されるときに新しいプランを作成するように、プロシージャ キャッシュから既存のプランを削除することによって行われます。 SQL Server Profiler コレクションでは、 イベントSP:CacheInsertではなく イベントがログにSP:Recompile記録されます。

Topic link iconTransact-SQL 構文表記規則

構文

sp_recompile [ @objname = ] 'object'  

引数

[ @objname= ] 'object'

現在のデータベースにあるストアド プロシージャ、トリガー、テーブル、ビュー、またはユーザー定義関数の修飾名または非修飾名を指定します。 objectnvarchar(776)で、既定値はありません。 object がストアド プロシージャ、トリガー、またはユーザー定義関数の名前である場合、ストアド プロシージャ、トリガー、または関数は次回実行されるときに再コンパイルされます。 object がテーブルまたはビューの名前の場合、テーブルまたはビューを参照するすべてのストアド プロシージャ、トリガー、またはユーザー定義関数は、次回実行されるときに再コンパイルされます。

リターン コードの値

0 (成功) または 0 以外の数値 (失敗)

解説

sp_recompile は、現在のデータベース内のオブジェクトのみを検索します。

ストアド プロシージャ、トリガー、およびユーザー定義関数が使用するクエリは、コンパイル時にだけ最適化されます。 データベースにインデックスを追加したり、変更を加えたりすると、統計が変化するため、コンパイルされたストアド プロシージャ、トリガー、およびユーザー定義関数の効率が低下する場合があります。 そのテーブルに作用するストアド プロシージャやトリガーを再コンパイルすることにより、クエリを再び最適化できます。

通常、このストアド プロシージャのプロアクティブな実行は不要です。 SQL Server便利な場合は、ストアド プロシージャ、トリガー、およびユーザー定義関数を自動的に再コンパイルします。 データベース エンジンがオブジェクトの再コンパイルを選択する理由はさまざまです。 最も一般的に、自動再コンパイルは、統計の自動更新または手動更新により、基になるカーディナリティ推定に対する変更に従います。

すべての実行でストアド プロシージャを再コンパイルすることは、パラメーター化によって引き起こされるクエリ プランの問題に対処するための効率の低い方法の 1 つです。 SQL Server 2022 (16.x) で導入されたパラメーター依存プランの最適化機能は、この問題を自動的に軽減しようとします。 以前のバージョンでは、各実行で を呼び出す sp_recompile 代わりに、次の点を考慮してください。

アクセス許可

指定したオブジェクトに対する ALTER 権限が必要です。

次の例では、Sales.Customer テーブルを対象とするストアド プロシージャ、トリガー、およびユーザー定義関数が次回実行時に再コンパイルされます。

USE AdventureWorks2012;  
GO  
EXEC sp_recompile N'Sales.Customer';  
GO  

関連項目

次のステップ